dlls/wined3d/volume.c

   1 /*
   2  * Copyright 2002-2005 Jason Edmeades
   3  * Copyright 2002-2005 Raphael Junqueira
   4  * Copyright 2005 Oliver Stieber
   5  * Copyright 2009-2011 Henri Verbeet for CodeWeavers
   6  * Copyright 2013 Stefan Dösinger for CodeWeavers
   7  *
   8  * This library is free software; you can redistribute it and/or
   9  * modify it under the terms of the GNU Lesser General Public
  10  * License as published by the Free Software Foundation; either
  11  * version 2.1 of the License, or (at your option) any later version.
  12  *
  13  * This library is distributed in the hope that it will be useful,
  14  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  15  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  16  * Lesser General Public License for more details.
  17  *
  18  * You should have received a copy of the GNU Lesser General Public
  19  * License along with this library; if not, write to the Free Software
  20  * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
  21  */
  22
  23 #include "config.h"
  24 #include "wine/port.h"
  25 #include "wined3d_private.h"
  26
  27 WINE_DEFAULT_DEBUG_CHANNEL(d3d_surface);
  28 WINE_DECLARE_DEBUG_CHANNEL(d3d_perf);
  29
  30 BOOL volume_prepare_system_memory(struct wined3d_volume *volume)
  31 {
  32     if (volume->resource.heap_memory)
  33         return TRUE;
  34
  35     if (!wined3d_resource_allocate_sysmem(&volume->resource))
  36     {
  37         ERR("Failed to allocate system memory.\n");
  38         return FALSE;
  39     }
  40     return TRUE;
  41 }
  42
  43 void wined3d_volume_get_pitch(const struct wined3d_volume *volume, UINT *row_pitch, UINT *slice_pitch)
  44 {
  45     const struct wined3d_format *format = volume->resource.format;
  46
  47     if (format->flags & WINED3DFMT_FLAG_BLOCKS)
  48     {
  49         /* Since compressed formats are block based, pitch means the amount of
  50          * bytes to the next row of block rather than the next row of pixels. */
  51         UINT row_block_count = (volume->resource.width + format->block_width - 1) / format->block_width;
  52         UINT slice_block_count = (volume->resource.height + format->block_height - 1) / format->block_height;
  53         *row_pitch = row_block_count * format->block_byte_count;
  54         *slice_pitch = *row_pitch * slice_block_count;
  55     }
  56     else
  57     {
  58         unsigned char alignment = volume->resource.device->surface_alignment;
  59         *row_pitch = format->byte_count * volume->resource.width;  /* Bytes / row */
  60         *row_pitch = (*row_pitch + alignment - 1) & ~(alignment - 1);
  61         *slice_pitch = *row_pitch * volume->resource.height;
  62     }
  63
  64     TRACE("Returning row pitch %u, slice pitch %u.\n", *row_pitch, *slice_pitch);
  65 }
  66
  67 /* Context activation is done by the caller. */
  68 void wined3d_volume_upload_data(struct wined3d_volume *volume, const struct wined3d_context *context,
  69         const struct wined3d_const_bo_address *data)
  70 {
  71     const struct wined3d_gl_info *gl_info = context->gl_info;
  72     const struct wined3d_format *format = volume->resource.format;
  73     UINT width = volume->resource.width;
  74     UINT height = volume->resource.height;
  75     UINT depth = volume->resource.depth;
  76     const void *mem = data->addr;
  77     void *converted_mem = NULL;
  78
  79     TRACE("volume %p, context %p, level %u, format %s (%#x).\n",
  80             volume, context, volume->texture_level, debug_d3dformat(format->id),
  81             format->id);
  82
  83     if (format->convert)
  84     {
  85         UINT dst_row_pitch, dst_slice_pitch;
  86         UINT src_row_pitch, src_slice_pitch;
  87
  88         if (data->buffer_object)
  89             ERR("Loading a converted volume from a PBO.\n");
  90         if (format->flags & WINED3DFMT_FLAG_BLOCKS)
  91             ERR("Converting a block-based format.\n");
  92
  93         dst_row_pitch = width * format->conv_byte_count;
  94         dst_slice_pitch = dst_row_pitch * height;
  95
  96         wined3d_volume_get_pitch(volume, &src_row_pitch, &src_slice_pitch);
  97
  98         converted_mem = HeapAlloc(GetProcessHeap(), 0, dst_slice_pitch * depth);
  99         format->convert(data->addr, converted_mem, src_row_pitch, src_slice_pitch,
 100                 dst_row_pitch, dst_slice_pitch, width, height, depth);
 101         mem = converted_mem;
 102     }
 103
 104     if (data->buffer_object)
 105     {
 106         GL_EXTCALL(glBindBuffer(GL_PIXEL_UNPACK_BUFFER, data->buffer_object));
 107         checkGLcall("glBindBuffer");
 108     }
 109
 110     GL_EXTCALL(glTexSubImage3D(GL_TEXTURE_3D, volume->texture_level, 0, 0, 0,
 111             width, height, depth,
 112             format->glFormat, format->glType, mem));
 113     checkGLcall("glTexSubImage3D");
 114
 115     if (data->buffer_object)
 116     {
 117         GL_EXTCALL(glBindBuffer(GL_PIXEL_UNPACK_BUFFER, 0));
 118         checkGLcall("glBindBuffer");
 119     }
 120
 121     HeapFree(GetProcessHeap(), 0, converted_mem);
 122 }
 123
 124 void wined3d_volume_validate_location(struct wined3d_volume *volume, DWORD location)
 125 {
 126     TRACE("Volume %p, setting %s.\n", volume, wined3d_debug_location(location));
 127     volume->locations |= location;
 128     TRACE("new location flags are %s.\n", wined3d_debug_location(volume->locations));
 129 }
 130
 131 void wined3d_volume_invalidate_location(struct wined3d_volume *volume, DWORD location)
 132 {
 133     TRACE("Volume %p, clearing %s.\n", volume, wined3d_debug_location(location));
 134     volume->locations &= ~location;
 135     TRACE("new location flags are %s.\n", wined3d_debug_location(volume->locations));
 136 }
 137
 138 /* Context activation is done by the caller. */
 139 static void wined3d_volume_download_data(struct wined3d_volume *volume,
 140         const struct wined3d_context *context, const struct wined3d_bo_address *data)
 141 {
 142     const struct wined3d_gl_info *gl_info = context->gl_info;
 143     const struct wined3d_format *format = volume->resource.format;
 144
 145     if (format->convert)
 146     {
 147         FIXME("Attempting to download a converted volume, format %s.\n",
 148                 debug_d3dformat(format->id));
 149         return;
 150     }
 151
 152     if (data->buffer_object)
 153     {
 154         GL_EXTCALL(glBindBuffer(GL_PIXEL_PACK_BUFFER, data->buffer_object));
 155         checkGLcall("glBindBuffer");
 156     }
 157
 158     gl_info->gl_ops.gl.p_glGetTexImage(GL_TEXTURE_3D, volume->texture_level,
 159             format->glFormat, format->glType, data->addr);
 160     checkGLcall("glGetTexImage");
 161
 162     if (data->buffer_object)
 163     {
 164         GL_EXTCALL(glBindBuffer(GL_PIXEL_PACK_BUFFER, 0));
 165         checkGLcall("glBindBuffer");
 166     }
 167
 168 }
 169
 170 static void wined3d_volume_evict_sysmem(struct wined3d_volume *volume)
 171 {
 172     wined3d_resource_free_sysmem(&volume->resource);
 173     wined3d_volume_invalidate_location(volume, WINED3D_LOCATION_SYSMEM);
 174 }
 175
 176 static DWORD volume_access_from_location(DWORD location)
 177 {
 178     switch (location)
 179     {
 180         case WINED3D_LOCATION_DISCARDED:
 181             return 0;
 182
 183         case WINED3D_LOCATION_SYSMEM:
 184             return WINED3D_RESOURCE_ACCESS_CPU;
 185
 186         case WINED3D_LOCATION_BUFFER:
 187         case WINED3D_LOCATION_TEXTURE_RGB:
 188         case WINED3D_LOCATION_TEXTURE_SRGB:
 189             return WINED3D_RESOURCE_ACCESS_GPU;
 190
 191         default:
 192             FIXME("Unhandled location %#x.\n", location);
 193             return 0;
 194     }
 195 }
 196
 197 /* Context activation is done by the caller. */
 198 static void wined3d_volume_srgb_transfer(struct wined3d_volume *volume,
 199         struct wined3d_context *context, BOOL dest_is_srgb)
 200 {
 201     struct wined3d_bo_address data;
 202     /* Optimizations are possible, but the effort should be put into either
 203      * implementing EXT_SRGB_DECODE in the driver or finding out why we
 204      * picked the wrong copy for the original upload and fixing that.
 205      *
 206      * Also keep in mind that we want to avoid using resource.heap_memory
 207      * for DEFAULT pool surfaces. */
 208
 209     WARN_(d3d_perf)("Performing slow rgb/srgb volume transfer.\n");
 210     data.buffer_object = 0;
 211     data.addr = HeapAlloc(GetProcessHeap(), 0, volume->resource.size);
 212     if (!data.addr)
 213         return;
 214
 215     wined3d_texture_bind_and_dirtify(volume->container, context, !dest_is_srgb);
 216     wined3d_volume_download_data(volume, context, &data);
 217     wined3d_texture_bind_and_dirtify(volume->container, context, dest_is_srgb);
 218     wined3d_volume_upload_data(volume, context, wined3d_const_bo_address(&data));
 219
 220     HeapFree(GetProcessHeap(), 0, data.addr);
 221 }
 222
 223 static BOOL wined3d_volume_can_evict(const struct wined3d_volume *volume)
 224 {
 225     if (volume->resource.pool != WINED3D_POOL_MANAGED)
 226         return FALSE;
 227     if (volume->download_count >= 10)
 228         return FALSE;
 229     if (volume->resource.format->convert)
 230         return FALSE;
 231     if (volume->flags & WINED3D_VFLAG_CLIENT_STORAGE)
 232         return FALSE;
 233
 234     return TRUE;
 235 }
 236 /* Context activation is done by the caller. */
 237 static void wined3d_volume_load_location(struct wined3d_volume *volume,
 238         struct wined3d_context *context, DWORD location)
 239 {
 240     DWORD required_access = volume_access_from_location(location);
 241
 242     TRACE("Volume %p, loading %s, have %s.\n", volume, wined3d_debug_location(location),
 243         wined3d_debug_location(volume->locations));
 244
 245     if ((volume->locations & location) == location)
 246     {
 247         TRACE("Location(s) already up to date.\n");
 248         return;
 249     }
 250
 251     if ((volume->resource.access_flags & required_access) != required_access)
 252     {
 253         ERR("Operation requires %#x access, but volume only has %#x.\n",
 254                 required_access, volume->resource.access_flags);
 255         return;
 256     }
 257
 258     switch (location)
 259     {
 260         case WINED3D_LOCATION_TEXTURE_RGB:
 261         case WINED3D_LOCATION_TEXTURE_SRGB:
 262             if ((location == WINED3D_LOCATION_TEXTURE_RGB
 263                     && !(volume->container->flags & WINED3D_TEXTURE_RGB_ALLOCATED))
 264                     || (location == WINED3D_LOCATION_TEXTURE_SRGB
 265                     && !(volume->container->flags & WINED3D_TEXTURE_SRGB_ALLOCATED)))
 266                 ERR("Trying to load (s)RGB texture without prior allocation.\n");
 267
 268             if (volume->locations & WINED3D_LOCATION_DISCARDED)
 269             {
 270                 TRACE("Volume previously discarded, nothing to do.\n");
 271                 wined3d_volume_invalidate_location(volume, WINED3D_LOCATION_DISCARDED);
 272             }
 273             else if (volume->locations & WINED3D_LOCATION_SYSMEM)
 274             {
 275                 struct wined3d_const_bo_address data = {0, volume->resource.heap_memory};
 276                 wined3d_volume_upload_data(volume, context, &data);
 277             }
 278             else if (volume->locations & WINED3D_LOCATION_BUFFER)
 279             {
 280                 struct wined3d_const_bo_address data = {volume->pbo, NULL};
 281                 wined3d_volume_upload_data(volume, context, &data);
 282             }
 283             else if (volume->locations & WINED3D_LOCATION_TEXTURE_RGB)
 284             {
 285                 wined3d_volume_srgb_transfer(volume, context, TRUE);
 286             }
 287             else if (volume->locations & WINED3D_LOCATION_TEXTURE_SRGB)
 288             {
 289                 wined3d_volume_srgb_transfer(volume, context, FALSE);
 290             }
 291             else
 292             {
 293                 FIXME("Implement texture loading from %s.\n", wined3d_debug_location(volume->locations));
 294                 return;
 295             }
 296             wined3d_volume_validate_location(volume, location);
 297
 298             if (wined3d_volume_can_evict(volume))
 299                 wined3d_volume_evict_sysmem(volume);
 300
 301             break;
 302
 303         case WINED3D_LOCATION_SYSMEM:
 304             if (!volume->resource.heap_memory)
 305                 ERR("Trying to load WINED3D_LOCATION_SYSMEM without setting it up first.\n");
 306
 307             if (volume->locations & WINED3D_LOCATION_DISCARDED)
 308             {
 309                 TRACE("Volume previously discarded, nothing to do.\n");
 310                 wined3d_volume_invalidate_location(volume, WINED3D_LOCATION_DISCARDED);
 311             }
 312             else if (volume->locations & (WINED3D_LOCATION_TEXTURE_RGB | WINED3D_LOCATION_TEXTURE_SRGB))
 313             {
 314                 struct wined3d_bo_address data = {0, volume->resource.heap_memory};
 315
 316                 if (volume->locations & WINED3D_LOCATION_TEXTURE_RGB)
 317                     wined3d_texture_bind_and_dirtify(volume->container, context, FALSE);
 318                 else
 319                     wined3d_texture_bind_and_dirtify(volume->container, context, TRUE);
 320
 321                 volume->download_count++;
 322                 wined3d_volume_download_data(volume, context, &data);
 323             }
 324             else
 325             {
 326                 FIXME("Implement WINED3D_LOCATION_SYSMEM loading from %s.\n",
 327                         wined3d_debug_location(volume->locations));
 328                 return;
 329             }
 330             wined3d_volume_validate_location(volume, WINED3D_LOCATION_SYSMEM);
 331             break;
 332
 333         case WINED3D_LOCATION_BUFFER:
 334             if (!volume->pbo)
 335                 ERR("Trying to load WINED3D_LOCATION_BUFFER without setting it up first.\n");
 336
 337             if (volume->locations & WINED3D_LOCATION_DISCARDED)
 338             {
 339                 TRACE("Volume previously discarded, nothing to do.\n");
 340                 wined3d_volume_invalidate_location(volume, WINED3D_LOCATION_DISCARDED);
 341             }
 342             else if (volume->locations & (WINED3D_LOCATION_TEXTURE_RGB | WINED3D_LOCATION_TEXTURE_SRGB))
 343             {
 344                 struct wined3d_bo_address data = {volume->pbo, NULL};
 345
 346                 if (volume->locations & WINED3D_LOCATION_TEXTURE_RGB)
 347                     wined3d_texture_bind_and_dirtify(volume->container, context, FALSE);
 348                 else
 349                     wined3d_texture_bind_and_dirtify(volume->container, context, TRUE);
 350
 351                 wined3d_volume_download_data(volume, context, &data);
 352             }
 353             else
 354             {
 355                 FIXME("Implement WINED3D_LOCATION_BUFFER loading from %s.\n",
 356                         wined3d_debug_location(volume->locations));
 357                 return;
 358             }
 359             wined3d_volume_validate_location(volume, WINED3D_LOCATION_BUFFER);
 360             break;
 361
 362         default:
 363             FIXME("Implement %s loading from %s.\n", wined3d_debug_location(location),
 364                     wined3d_debug_location(volume->locations));
 365     }
 366 }
 367
 368 /* Context activation is done by the caller. */
 369 void wined3d_volume_load(struct wined3d_volume *volume, struct wined3d_context *context, BOOL srgb_mode)
 370 {
 371     wined3d_texture_prepare_texture(volume->container, context, srgb_mode);
 372     wined3d_volume_load_location(volume, context,
 373             srgb_mode ? WINED3D_LOCATION_TEXTURE_SRGB : WINED3D_LOCATION_TEXTURE_RGB);
 374 }
 375
 376 /* Context activation is done by the caller. */
 377 static void wined3d_volume_prepare_pbo(struct wined3d_volume *volume, struct wined3d_context *context)
 378 {
 379     const struct wined3d_gl_info *gl_info = context->gl_info;
 380
 381     if (volume->pbo)
 382         return;
 383
 384     GL_EXTCALL(glGenBuffers(1, &volume->pbo));
 385     GL_EXTCALL(glBindBuffer(GL_PIXEL_UNPACK_BUFFER, volume->pbo));
 386     GL_EXTCALL(glBufferData(GL_PIXEL_UNPACK_BUFFER, volume->resource.size, NULL, GL_STREAM_DRAW));
 387     GL_EXTCALL(glBindBuffer(GL_PIXEL_UNPACK_BUFFER, 0));
 388     checkGLcall("Create PBO");
 389
 390     TRACE("Created PBO %u for volume %p.\n", volume->pbo, volume);
 391 }
 392
 393 static void wined3d_volume_free_pbo(struct wined3d_volume *volume)
 394 {
 395     struct wined3d_context *context = context_acquire(volume->resource.device, NULL);
 396     const struct wined3d_gl_info *gl_info = context->gl_info;
 397
 398     TRACE("Deleting PBO %u belonging to volume %p.\n", volume->pbo, volume);
 399     GL_EXTCALL(glDeleteBuffers(1, &volume->pbo));
 400     checkGLcall("glDeleteBuffers");
 401     volume->pbo = 0;
 402     context_release(context);
 403 }
 404
 405 void wined3d_volume_destroy(struct wined3d_volume *volume)
 406 {
 407     TRACE("volume %p.\n", volume);
 408
 409     if (volume->pbo)
 410         wined3d_volume_free_pbo(volume);
 411
 412     resource_cleanup(&volume->resource);
 413     volume->resource.parent_ops->wined3d_object_destroyed(volume->resource.parent);
 414     HeapFree(GetProcessHeap(), 0, volume);
 415 }
 416
 417 static void volume_unload(struct wined3d_resource *resource)
 418 {
 419     struct wined3d_volume *volume = volume_from_resource(resource);
 420     struct wined3d_device *device = volume->resource.device;
 421     struct wined3d_context *context;
 422
 423     if (volume->resource.pool == WINED3D_POOL_DEFAULT)
 424         ERR("Unloading DEFAULT pool volume.\n");
 425
 426     TRACE("texture %p.\n", resource);
 427
 428     if (volume_prepare_system_memory(volume))
 429     {
 430         context = context_acquire(device, NULL);
 431         wined3d_volume_load_location(volume, context, WINED3D_LOCATION_SYSMEM);
 432         context_release(context);
 433         wined3d_volume_invalidate_location(volume, ~WINED3D_LOCATION_SYSMEM);
 434     }
 435     else
 436     {
 437         ERR("Out of memory when unloading volume %p.\n", volume);
 438         wined3d_volume_validate_location(volume, WINED3D_LOCATION_DISCARDED);
 439         wined3d_volume_invalidate_location(volume, ~WINED3D_LOCATION_DISCARDED);
 440     }
 441
 442     if (volume->pbo)
 443     {
 444         /* Should not happen because only dynamic default pool volumes
 445          * have a buffer, and those are not evicted by device_evit_managed_resources
 446          * and must be freed before a non-ex device reset. */
 447         ERR("Unloading a volume with a buffer\n");
 448         wined3d_volume_free_pbo(volume);
 449     }
 450
 451     /* The texture name is managed by the container. */
 452     volume->flags &= ~WINED3D_VFLAG_CLIENT_STORAGE;
 453
 454     resource_unload(resource);
 455 }
 456
 457 ULONG CDECL wined3d_volume_incref(struct wined3d_volume *volume)
 458 {
 459     TRACE("Forwarding to container %p.\n", volume->container);
 460
 461     return wined3d_texture_incref(volume->container);
 462 }
 463
 464 ULONG CDECL wined3d_volume_decref(struct wined3d_volume *volume)
 465 {
 466     TRACE("Forwarding to container %p.\n", volume->container);
 467
 468     return wined3d_texture_decref(volume->container);
 469 }
 470
 471 void * CDECL wined3d_volume_get_parent(const struct wined3d_volume *volume)
 472 {
 473     TRACE("volume %p.\n", volume);
 474
 475     return volume->resource.parent;
 476 }
 477
 478 void CDECL wined3d_volume_preload(struct wined3d_volume *volume)
 479 {
 480     FIXME("volume %p stub!\n", volume);
 481 }
 482
 483 struct wined3d_resource * CDECL wined3d_volume_get_resource(struct wined3d_volume *volume)
 484 {
 485     TRACE("volume %p.\n", volume);
 486
 487     return &volume->resource;
 488 }
 489
 490 static BOOL volume_check_block_align(const struct wined3d_volume *volume,
 491         const struct wined3d_box *box)
 492 {
 493     UINT width_mask, height_mask;
 494     const struct wined3d_format *format = volume->resource.format;
 495
 496     if (!box)
 497         return TRUE;
 498
 499     /* This assumes power of two block sizes, but NPOT block sizes would be
 500      * silly anyway.
 501      *
 502      * This also assumes that the format's block depth is 1. */
 503     width_mask = format->block_width - 1;
 504     height_mask = format->block_height - 1;
 505
 506     if (box->left & width_mask)
 507         return FALSE;
 508     if (box->top & height_mask)
 509         return FALSE;
 510     if (box->right & width_mask && box->right != volume->resource.width)
 511         return FALSE;
 512     if (box->bottom & height_mask && box->bottom != volume->resource.height)
 513         return FALSE;
 514
 515     return TRUE;
 516 }
 517
 518 static BOOL wined3d_volume_check_box_dimensions(const struct wined3d_volume *volume,
 519         const struct wined3d_box *box)
 520 {
 521     if (!box)
 522         return TRUE;
 523
 524     if (box->left >= box->right)
 525         return FALSE;
 526     if (box->top >= box->bottom)
 527         return FALSE;
 528     if (box->front >= box->back)
 529         return FALSE;
 530     if (box->right > volume->resource.width)
 531         return FALSE;
 532     if (box->bottom > volume->resource.height)
 533         return FALSE;
 534     if (box->back > volume->resource.depth)
 535         return FALSE;
 536
 537     return TRUE;
 538 }
 539
 540 HRESULT CDECL wined3d_volume_map(struct wined3d_volume *volume,
 541         struct wined3d_map_desc *map_desc, const struct wined3d_box *box, DWORD flags)
 542 {
 543     struct wined3d_device *device = volume->resource.device;
 544     struct wined3d_context *context;
 545     const struct wined3d_gl_info *gl_info;
 546     BYTE *base_memory;
 547     const struct wined3d_format *format = volume->resource.format;
 548
 549     TRACE("volume %p, map_desc %p, box %p, flags %#x.\n",
 550             volume, map_desc, box, flags);
 551
 552     map_desc->data = NULL;
 553     if (!(volume->resource.access_flags & WINED3D_RESOURCE_ACCESS_CPU))
 554     {
 555         WARN("Volume %p is not CPU accessible.\n", volume);
 556         return WINED3DERR_INVALIDCALL;
 557     }
 558     if (volume->resource.map_count)
 559     {
 560         WARN("Volume is already mapped.\n");
 561         return WINED3DERR_INVALIDCALL;
 562     }
 563     if (!wined3d_volume_check_box_dimensions(volume, box))
 564     {
 565         WARN("Map box is invalid.\n");
 566         return WINED3DERR_INVALIDCALL;
 567     }
 568     if ((format->flags & WINED3DFMT_FLAG_BLOCKS) && !volume_check_block_align(volume, box))
 569     {
 570         WARN("Map box is misaligned for %ux%u blocks.\n",
 571                 format->block_width, format->block_height);
 572         return WINED3DERR_INVALIDCALL;
 573     }
 574
 575     flags = wined3d_resource_sanitize_map_flags(&volume->resource, flags);
 576
 577     if (volume->resource.map_binding == WINED3D_LOCATION_BUFFER)
 578     {
 579         context = context_acquire(device, NULL);
 580         gl_info = context->gl_info;
 581
 582         wined3d_volume_prepare_pbo(volume, context);
 583         if (flags & WINED3D_MAP_DISCARD)
 584             wined3d_volume_validate_location(volume, WINED3D_LOCATION_BUFFER);
 585         else
 586             wined3d_volume_load_location(volume, context, WINED3D_LOCATION_BUFFER);
 587
 588         GL_EXTCALL(glBindBuffer(GL_PIXEL_UNPACK_BUFFER, volume->pbo));
 589
 590         if (gl_info->supported[ARB_MAP_BUFFER_RANGE])
 591         {
 592             GLbitfield mapflags = wined3d_resource_gl_map_flags(flags);
 593             mapflags &= ~GL_MAP_FLUSH_EXPLICIT_BIT;
 594             base_memory = GL_EXTCALL(glMapBufferRange(GL_PIXEL_UNPACK_BUFFER,
 595                     0, volume->resource.size, mapflags));
 596         }
 597         else
 598         {
 599             GLenum access = wined3d_resource_gl_legacy_map_flags(flags);
 600             base_memory = GL_EXTCALL(glMapBuffer(GL_PIXEL_UNPACK_BUFFER, access));
 601         }
 602
 603         GL_EXTCALL(glBindBuffer(GL_PIXEL_UNPACK_BUFFER, 0));
 604         checkGLcall("Map PBO");
 605
 606         context_release(context);
 607     }
 608     else
 609     {
 610         if (!volume_prepare_system_memory(volume))
 611         {
 612             WARN("Out of memory.\n");
 613             map_desc->data = NULL;
 614             return E_OUTOFMEMORY;
 615         }
 616
 617         if (flags & WINED3D_MAP_DISCARD)
 618         {
 619             wined3d_volume_validate_location(volume, WINED3D_LOCATION_SYSMEM);
 620         }
 621         else if (!(volume->locations & WINED3D_LOCATION_SYSMEM))
 622         {
 623             context = context_acquire(device, NULL);
 624             wined3d_volume_load_location(volume, context, WINED3D_LOCATION_SYSMEM);
 625             context_release(context);
 626         }
 627         base_memory = volume->resource.heap_memory;
 628     }
 629
 630     TRACE("Base memory pointer %p.\n", base_memory);
 631
 632     if (format->flags & WINED3DFMT_FLAG_BROKEN_PITCH)
 633     {
 634         map_desc->row_pitch = volume->resource.width * format->byte_count;
 635         map_desc->slice_pitch = map_desc->row_pitch * volume->resource.height;
 636     }
 637     else
 638     {
 639         wined3d_volume_get_pitch(volume, &map_desc->row_pitch, &map_desc->slice_pitch);
 640     }
 641
 642     if (!box)
 643     {
 644         TRACE("No box supplied - all is ok\n");
 645         map_desc->data = base_memory;
 646     }
 647     else
 648     {
 649         TRACE("Lock Box (%p) = l %u, t %u, r %u, b %u, fr %u, ba %u\n",
 650                 box, box->left, box->top, box->right, box->bottom, box->front, box->back);
 651
 652         if ((format->flags & (WINED3DFMT_FLAG_BLOCKS | WINED3DFMT_FLAG_BROKEN_PITCH)) == WINED3DFMT_FLAG_BLOCKS)
 653         {
 654             /* Compressed textures are block based, so calculate the offset of
 655              * the block that contains the top-left pixel of the locked rectangle. */
 656             map_desc->data = base_memory
 657                     + (box->front * map_desc->slice_pitch)
 658                     + ((box->top / format->block_height) * map_desc->row_pitch)
 659                     + ((box->left / format->block_width) * format->block_byte_count);
 660         }
 661         else
 662         {
 663             map_desc->data = base_memory
 664                     + (map_desc->slice_pitch * box->front)
 665                     + (map_desc->row_pitch * box->top)
 666                     + (box->left * volume->resource.format->byte_count);
 667         }
 668     }
 669
 670     if (!(flags & (WINED3D_MAP_NO_DIRTY_UPDATE | WINED3D_MAP_READONLY)))
 671     {
 672         wined3d_texture_set_dirty(volume->container);
 673         wined3d_volume_invalidate_location(volume, ~volume->resource.map_binding);
 674     }
 675
 676     volume->resource.map_count++;
 677
 678     TRACE("Returning memory %p, row pitch %d, slice pitch %d.\n",
 679             map_desc->data, map_desc->row_pitch, map_desc->slice_pitch);
 680
 681     return WINED3D_OK;
 682 }
 683
 684 struct wined3d_volume * CDECL wined3d_volume_from_resource(struct wined3d_resource *resource)
 685 {
 686     return volume_from_resource(resource);
 687 }
 688
 689 HRESULT CDECL wined3d_volume_unmap(struct wined3d_volume *volume)
 690 {
 691     TRACE("volume %p.\n", volume);
 692
 693     if (!volume->resource.map_count)
 694     {
 695         WARN("Trying to unlock an unlocked volume %p.\n", volume);
 696         return WINED3DERR_INVALIDCALL;
 697     }
 698
 699     if (volume->resource.map_binding == WINED3D_LOCATION_BUFFER)
 700     {
 701         struct wined3d_device *device = volume->resource.device;
 702         struct wined3d_context *context = context_acquire(device, NULL);
 703         const struct wined3d_gl_info *gl_info = context->gl_info;
 704
 705         GL_EXTCALL(glBindBuffer(GL_PIXEL_UNPACK_BUFFER, volume->pbo));
 706         GL_EXTCALL(glUnmapBuffer(GL_PIXEL_UNPACK_BUFFER));
 707         GL_EXTCALL(glBindBuffer(GL_PIXEL_UNPACK_BUFFER, 0));
 708         checkGLcall("Unmap PBO");
 709
 710         context_release(context);
 711     }
 712
 713     volume->resource.map_count--;
 714
 715     return WINED3D_OK;
 716 }
 717
 718 static ULONG volume_resource_incref(struct wined3d_resource *resource)
 719 {
 720     return wined3d_volume_incref(volume_from_resource(resource));
 721 }
 722
 723 static ULONG volume_resource_decref(struct wined3d_resource *resource)
 724 {
 725     return wined3d_volume_decref(volume_from_resource(resource));
 726 }
 727
 728 static const struct wined3d_resource_ops volume_resource_ops =
 729 {
 730     volume_resource_incref,
 731     volume_resource_decref,
 732     volume_unload,
 733 };
 734
 735 static HRESULT volume_init(struct wined3d_volume *volume, struct wined3d_texture *container,
 736         const struct wined3d_resource_desc *desc, UINT level)
 737 {
 738     struct wined3d_device *device = container->resource.device;
 739     const struct wined3d_gl_info *gl_info = &device->adapter->gl_info;
 740     const struct wined3d_format *format = wined3d_get_format(gl_info, desc->format);
 741     HRESULT hr;
 742     UINT size;
 743
 744     if (!gl_info->supported[EXT_TEXTURE3D])
 745     {
 746         WARN("Volume cannot be created - no volume texture support.\n");
 747         return WINED3DERR_INVALIDCALL;
 748     }
 749     /* TODO: Write tests for other resources and move this check
 750      * to resource_init, if applicable. */
 751     if (desc->usage & WINED3DUSAGE_DYNAMIC
 752             && (desc->pool == WINED3D_POOL_MANAGED || desc->pool == WINED3D_POOL_SCRATCH))
 753     {
 754         WARN("Attempted to create a DYNAMIC texture in pool %s.\n", debug_d3dpool(desc->pool));
 755         return WINED3DERR_INVALIDCALL;
 756     }
 757
 758     size = wined3d_format_calculate_size(format, device->surface_alignment, desc->width, desc->height, desc->depth);
 759
 760     if (FAILED(hr = resource_init(&volume->resource, device, WINED3D_RTYPE_VOLUME, format,
 761             WINED3D_MULTISAMPLE_NONE, 0, desc->usage, desc->pool, desc->width, desc->height, desc->depth,
 762             size, NULL, &wined3d_null_parent_ops, &volume_resource_ops)))
 763     {
 764         WARN("Failed to initialize resource, returning %#x.\n", hr);
 765         return hr;
 766     }
 767
 768     volume->texture_level = level;
 769     volume->locations = WINED3D_LOCATION_DISCARDED;
 770
 771     if (desc->pool == WINED3D_POOL_DEFAULT && desc->usage & WINED3DUSAGE_DYNAMIC
 772             && gl_info->supported[ARB_PIXEL_BUFFER_OBJECT]
 773             && !format->convert)
 774     {
 775         wined3d_resource_free_sysmem(&volume->resource);
 776         volume->resource.map_binding = WINED3D_LOCATION_BUFFER;
 777     }
 778
 779     volume->container = container;
 780
 781     return WINED3D_OK;
 782 }
 783
 784 HRESULT wined3d_volume_create(struct wined3d_texture *container, const struct wined3d_resource_desc *desc,
 785         unsigned int level, struct wined3d_volume **volume)
 786 {
 787     struct wined3d_device_parent *device_parent = container->resource.device->device_parent;
 788     const struct wined3d_parent_ops *parent_ops;
 789     struct wined3d_volume *object;
 790     void *parent;
 791     HRESULT hr;
 792
 793     TRACE("container %p, width %u, height %u, depth %u, level %u, format %s, "
 794             "usage %#x, pool %s, volume %p.\n",
 795             container, desc->width, desc->height, desc->depth, level, debug_d3dformat(desc->format),
 796             desc->usage, debug_d3dpool(desc->pool), volume);
 797
 798     if (!(object = HeapAlloc(GetProcessHeap(), HEAP_ZERO_MEMORY, sizeof(*object))))
 799         return E_OUTOFMEMORY;
 800
 801     if (FAILED(hr = volume_init(object, container, desc, level)))
 802     {
 803         WARN("Failed to initialize volume, returning %#x.\n", hr);
 804         HeapFree(GetProcessHeap(), 0, object);
 805         return hr;
 806     }
 807
 808     if (FAILED(hr = device_parent->ops->volume_created(device_parent,
 809             wined3d_texture_get_parent(container), object, &parent, &parent_ops)))
 810     {
 811         WARN("Failed to create volume parent, hr %#x.\n", hr);
 812         wined3d_volume_destroy(object);
 813         return hr;
 814     }
 815
 816     TRACE("Created volume %p, parent %p, parent_ops %p.\n", object, parent, parent_ops);
 817
 818     object->resource.parent = parent;
 819     object->resource.parent_ops = parent_ops;
 820     *volume = object;
 821
 822     return WINED3D_OK;
 823 }