D2D1_IMAGE_SOURCE_LOADING_OPTIONS enumeration

Controls option flags for a new ID2D1ImageSource when it is created.

Syntax


typedef enum D2D1_IMAGE_SOURCE_LOADING_OPTIONS { 
  D2D1_IMAGE_SOURCE_LOADING_OPTIONS_NONE             = 0,
  D2D1_IMAGE_SOURCE_LOADING_OPTIONS_RELEASE_SOURCE   = 1,
  D2D1_IMAGE_SOURCE_LOADING_OPTIONS_CACHE_ON_DEMAND  = 2
} D2D1_IMAGE_SOURCE_LOADING_OPTIONS;

Constants

D2D1_IMAGE_SOURCE_LOADING_OPTIONS_NONE

No options are used.

D2D1_IMAGE_SOURCE_LOADING_OPTIONS_RELEASE_SOURCE

Indicates the image source should release its reference to the WIC bitmap source after it has initialized. By default, the image source retains a reference to the WIC bitmap source for the lifetime of the object to enable quality and speed optimizations for printing. This option disables that optimization.

D2D1_IMAGE_SOURCE_LOADING_OPTIONS_CACHE_ON_DEMAND

Indicates the image source should only populate subregions of the image cache on-demand. You can control this behavior using the EnsureCached and TrimCache methods. This options provides the ability to improve memory usage by only keeping needed portions of the image in memory. This option requires that the image source has a reference to the WIC bitmap source, and is incompatible with D2D1_IMAGE_SOURCE_LOADING_OPTIONS_RELEASE_SOURCE.

Remarks

 

D2D1_IMAGE_SOURCE_CREATION_OPTIONS_RELEASE_SOURCE causes the image source to not retain a reference to the source object used to create it. It can decrease the quality and efficiency of printing.

Requirements

Minimum supported client

Windows 10 [desktop apps | UWP apps]

Minimum supported server

Windows Server 2016 [desktop apps | Windows Store apps]

Minimum supported phone

Windows 10 Mobile

Header

D2d1_3.h

 

 

Show: