LFileSettings::SetViewMode2D

#include "ltwrappr.h"

static L_INT LFileSettings::SetViewMode2D(nViewMode)

L_INT nViewMode;

/* viewport mode */

Sets the current viewport mode used when loading 3D file formats.

Parameter

Description

nViewMode

New viewport mode. Possible values are:

 

Value

Meaning

 

L2D_USE_BEST

Fit the drawing into current viewport width and height. Final image size is less than or equal to viewport size.

 

L2D_USE_WIDTH

Use the current viewport width. Calculate new height, preserving the aspect ratio. Final image size has the same width as the current viewport width, with the height less than or equal to the current viewport height.

 

L2D_USE_HEIGHT

Use the current viewport height. Calculate the new width, preserving the aspect ratio. Final image size has the same height as the current viewport height, with the width less than or equal to the current viewport width.

 

L2D_USE_WIDTH_HEIGHT

Use both the width and the height (stretch image if necessary). Final image size has the same width and height as the current viewport size.

Returns

SUCCESS

The function was successful.

< 1

An error occurred. Refer to Return Codes.

Comments

A 3D file format usually doesn't have a physical size. The user can specify a viewport (physical size up to which the drawing can be rendered) with LFileSettings::SetViewport2D . How the drawing is to be rendered inside this viewport depends on the current viewport mode set with LFileSettings::SetViewMode2D. Default viewport size is 640x480 pixels.

When working with DXF files, you can use the Vector features, available in selected products, or you can use the Main C++ Class Library. If you use the Main C++ Class Library for loading, using the standard loading functions, you can modify the view port and view mode using the following functions:

LFileSettings::GetViewMode2D

LFileSettings::SetViewMode2D

LFileSettings::GetViewport2D

LFileSettings::SetViewport2D

This function may be used with the following Vector file formats: DXF, DWG, WMF, EMF, PCT, CGM, DRW, PLT, TIF (with a DXF saved internally) and Intergraph Vector. For more information on these file formats and their availability, refer to Summary of All Supported Image File Formats.

Required DLLs and Libraries

LTFIL
File format DLLs

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

Platforms

Win32, x64.

See Also

Functions:

LFileSettings::GetViewMode2D, LFileSettings::GetViewport2D, LFileSettings::SetViewport2D, LFileSettings::GetLoadResolution, LFileSettings::GetPCDResolution, LFileSettings::GetWMFResolution LFileSettings::SetLoadResolution, LFileSettings::SetPCDResolution, LFileSettings::SetWMFResolution, LFileSettings::GetWMFResolution, LFileSettings::SetWMFResolution

Topics:

Raster Image Functions: Rasterizing Files

Example

L_INT LFileSettings__SetViewMode2DExample( HWND hWnd )
{
   UNREFERENCED_PARAMETER(hWnd);
   L_INT nRet;
   /* Set viewport mode to L2D_USE_WIDTH_AND_HEIGHT */
   nRet = LFileSettings::SetViewMode2D( L2D_USE_WIDTH_HEIGHT );
   if(nRet != SUCCESS)
      return nRet;
   /* Set viewport size to 400*400 pixels */
   nRet = LFileSettings::SetViewport2D( 400, 400 );
   if(nRet != SUCCESS)
      return nRet;
   return SUCCESS;
}