Functions | |
| HRESULT | D3DBlt (CVD3DOBJECT d3dObjectSource, CVD3DOBJECT d3dObjectTarget) |
| This function blits a given source surface/ texture to a given destination surface/ texture. | |
| HRESULT | D3DBltRect (CVD3DOBJECT d3dObjectSource, const RECT *pSourceRect, CVD3DOBJECT d3dObjectTarget, const RECT *pTargetRect) |
| This function blits a given source surface/ texture to a given destination surface/ texture. | |
| HRESULT | D3DCreateSurface (CVD3D d3d, DWORD dwWidth, DWORD dwHeight, TColorFormat tcf, CVD3DOBJECT &d3dObject) |
| Creates a surface render target. | |
| HRESULT | D3DCreateSurfaceEntrance (CVD3D d3d, DWORD dwWidth, DWORD dwHeight, TColorFormat tcf, CVD3DOBJECT &d3dObject) |
| Creates a source surface. | |
| HRESULT | D3DGetBackbuffer (CVD3D d3d, CVD3DOBJECT &d3dObject) |
| Returns the backbuffer attached to the given D3D context. | |
| BOOL | D3DIsBltSource (CVD3DOBJECT d3dObject) |
| This function checks whether or not the given object can be used as a source for blit operations. | |
| BOOL | D3DIsBltTarget (CVD3DOBJECT d3dObject) |
| This function checks whether or not the given object can be used as a target for blit operations. | |
| HRESULT D3DBlt | ( | CVD3DOBJECT | d3dObjectSource, |
| CVD3DOBJECT | d3dObjectTarget | ||
| ) |
This function blits a given source surface/ texture to a given destination surface/ texture.
The image will be stretched during blitting if the image sizes don't match.
| XRGB Targets | XRGB Source | |||
| SurfaceEntrance | Surface | TextureEntrance | Texture | |
| WriteImageToObject | ok | ok | ok | - |
| Blt to Backbuffer | ok | ok | - | ok |
| Blt to SurfaceEntrance | ok | - | - | - |
| Blt to Surface | ok | ok | - | ok |
| Blt to TextureEntrance | - | - | - | - |
| Blt to Texture | ok | ok | - | ok |
| [in] | d3dObjectSource | The source surface. |
| [in] | d3dObjectTarget | The destination surface. |
0 if no error occurred, otherwise a value != 0 indicates the error code. | HRESULT D3DBltRect | ( | CVD3DOBJECT | d3dObjectSource, |
| const RECT * | pSourceRect, | ||
| CVD3DOBJECT | d3dObjectTarget, | ||
| const RECT * | pTargetRect | ||
| ) |
This function blits a given source surface/ texture to a given destination surface/ texture.
source and a target rectangular AOI are supported. The image will be stretched during blitting if the image sizes of the two AOIs don't match. If both AOIs are set to NULL the function behaves like D3DBlt.
| XRGB Targets | XRGB Source | |||
| SurfaceEntrance | Surface | TextureEntrance | Texture | |
| WriteImageToObject | ok | ok | ok | - |
| Blt to Backbuffer | ok | ok | - | ok |
| Blt to SurfaceEntrance | ok | - | - | - |
| Blt to Surface | ok | ok | - | ok |
| Blt to TextureEntrance | - | - | - | - |
| Blt to Texture | ok | ok | - | ok |
| [in] | d3dObjectSource | The source surface. |
| [in] | pSourceRect | The source AOI. |
| [in] | d3dObjectTarget | The destination surface. |
| [in] | pTargetRect | The destination AOI. |
0 if no error occurred, otherwise a value != 0 indicates the error code. | HRESULT D3DCreateSurface | ( | CVD3D | d3d, |
| DWORD | dwWidth, | ||
| DWORD | dwHeight, | ||
| TColorFormat | tcf, | ||
| CVD3DOBJECT & | d3dObject | ||
| ) |
Creates a surface render target.
The object may be used to render another object to itself. It may also be used as a source or target for blitting operations. To transfer the image back to the host call D3DUpdate after rendering.
ShareObject and ReleaseObject functions of the Image Manager. To finally free the object use ReleaseObject. | [in] | d3d | The D3D context. |
| [in] | dwWidth | The width of the image (has to be less or equal to the maximum width of the D3D context). |
| [in] | dwHeight | The height of the image (has to be less or equal to the maximum height of the D3D context). |
| [in] | tcf | The colour format of the image. See TColorFormat for possible colour formats. |
| [out] | d3dObject | Handle to the newly created CVD3DOBJECT object. |
0 if no error occurred, otherwise a value != 0 indicates the error code. | HRESULT D3DCreateSurfaceEntrance | ( | CVD3D | d3d, |
| DWORD | dwWidth, | ||
| DWORD | dwHeight, | ||
| TColorFormat | tcf, | ||
| CVD3DOBJECT & | d3dObject | ||
| ) |
Creates a source surface.
Typically you will write a host image to this surface using D3DWriteImageToObject and use it as a source for blitting operations.
ShareObject and ReleaseObject functions of the Image Manager. To finally free the object use ReleaseObject. | [in] | d3d | The D3D context. |
| [in] | dwWidth | The width of the image which has to be less or equal to the maximum width of the D3D context. |
| [in] | dwHeight | The height of the image which has to be less or equal to the maximum height of the D3D context. |
| [in] | tcf | The colour format of the image. See TColorFormat for possible colour formats. |
| [out] | d3dObject | Handle to the newly created CVD3DOBJECT object. |
0 if no error occurred, otherwise a value != 0 indicates the error code. | HRESULT D3DGetBackbuffer | ( | CVD3D | d3d, |
| CVD3DOBJECT & | d3dObject | ||
| ) |
Returns the backbuffer attached to the given D3D context.
The object can be used as a source or target for blitting operations.
ReleaseObject to free the memory. | [in] | d3d | The D3D context. |
| [out] | d3dObject | CVD3DOBJECT pointing to the backbuffer. |
0 if no error occurred, otherwise a value != 0 indicates the error code. | BOOL D3DIsBltSource | ( | CVD3DOBJECT | d3dObject | ) |
This function checks whether or not the given object can be used as a source for blit operations.
| [in] | d3dObject | Handle to the object to be processed. |
TRUE if it can be used as a blit source, FALSE otherwise. | BOOL D3DIsBltTarget | ( | CVD3DOBJECT | d3dObject | ) |
This function checks whether or not the given object can be used as a target for blit operations.
| [in] | d3dObject | Handle to the object to be processed. |
TRUE if it can be used as a blit target, FALSE otherwise.