GA_loadRef2d

Loads the 2D reference rasteriser device driver chain, including filter drivers.

Declaration

ibool NAPI GA_loadRef2d(
    GA_devCtx _FAR_ *dc,
    N_int32 shared,
    GA_modeInfo _FAR_ *modeInfo,
    N_int32 transferStart,
    REF2D_driver _FAR_ *_FAR_ *drv)

Prototype In

snap/graphics.h

Parameters

dc

Device to load reference rasteriser for

shared

True if the device driver should be loaded into shared memory

modeInfo

Mode information for the hardware display mode in use

transferStart

Start of the offscreen transfer buffer area in bytes

drv

Pointer to the place to store loaded driver address

 

Return Value

True on success, false on failure.

Description

This function loads a copy of the SNAP 2D Reference Rasteriser from disk for use with the specified hardware display mode. If the user has enabled rotation display support, or multi-controller display support, this function will load and initialise all the necessary SNAP filter drivers to enable those functions for the specified display mode.

The transferStart parameter is used to determine where the start of the offscreen display memory transfer buffer is located. This transfer buffer is used by the Portrait and Multi-Controller filter drivers for storing temporary bitmap images in offscreen display memory for enhanced performance. If the amount of memory from the start of the transfer area to the end of available offscreen display memory is large enough to hold the transfer buffer (no more than an entire display screen is ever required), then the filter drivers will use that memory as necessary. If the amount of available memory is less than required, the filter drivers will use system memory buffers instead. To disable the use of the transfer buffer, simply pass in a value that is equal to the amount of video memory on the graphics adapter in bytes.

See Also

GA_unloadRef2d, GA_unloadDriver, GA_getCurrentRef2d

Copyright © 2002 SciTech Software, Inc. Visit our web site at http://www.scitechsoft.com