Package org.lwjgl.system.windows
Class DEVMODE
- java.lang.Object
-
- org.lwjgl.system.Pointer.Default
-
- org.lwjgl.system.Struct
-
- org.lwjgl.system.windows.DEVMODE
-
- All Implemented Interfaces:
- java.lang.AutoCloseable, NativeResource, Pointer
public class DEVMODE extends Struct
Contains information about the initialization and environment of a printer or a display device.Member documentation
dmDeviceName– A zero-terminated character array that specifies the "friendly" name of the printer or display; for example, "PCL/HP LaserJet" in the case of PCL/HP LaserJet. This string is unique among device drivers. Note that this name may be truncated to fit in thedmDeviceNamearray.dmSpecVersion– the version number of the initialization data specification on which the structure is based. To ensure the correct version is used for any operating system, useGDI32.DM_SPECVERSION.dmDriverVersion– the driver version number assigned by the driver developerdmSize– specifies the size, in bytes, of theDEVMODEstructure, not including any private driver-specific data that might follow the structure's public members. Set this member toDEVMODE.SIZEOFto indicate the version of theDEVMODEstructure being used.dmDriverExtra– contains the number of bytes of private driver-data that follow this structure. If a device driver does not use device-specific information, set this member to zero.dmFields– specifies whether certain members of theDEVMODEstructure have been initialized. If a member is initialized, its corresponding bit is set otherwise the bit is clear. A driver supports only thoseDEVMODEmembers that are appropriate for the printer or display technology.dmOrientation– for printer devices onlydmPaperSize– for printer devices onlydmPaperLength– for printer devices onlydmPaperWidth– for printer devices onlydmScale– for printer devices onlydmCopies– for printer devices onlydmDefaultSource– for printer devices onlydmPrintQuality– for printer devices onlydmPosition– for display devices only, aPOINTLstructure that indicates the positional coordinates of the display device in reference to the desktop area. The primary display device is always located at coordinates (0,0).dmDisplayOrientation– for display devices only, the orientation at which images should be presented. IfGDI32.DM_DISPLAYORIENTATIONis not set, this member must be zero. IfGDI32.DM_DISPLAYORIENTATIONis set, this member must be one of the following values:GDI32.DMDO_DEFAULT,GDI32.DMDO_90,GDI32.DMDO_180,GDI32.DMDO_270To determine whether the display orientation is portrait or landscape orientation, check the ratio of
dmPelsWidthtodmPelsHeight.dmDisplayFixedOutput– for fixed-resolution display devices only, how the display presents a low-resolution mode on a higher-resolution display. For example, if a display device's resolution is fixed at 1024 x 768 pixels but its mode is set to 640 x 480 pixels, the device can either display a 640 x 480 image somewhere in the interior of the 1024 x 768 screen space or stretch the 640 x 480 image to fill the larger screen space. IfGDI32.DM_DISPLAYFIXEDOUTPUTis not set, this member must be zero. IfGDI32.DM_DISPLAYFIXEDOUTPUTis set, this member must be one of the following values:GDI32.DMDFO_DEFAULT,GDI32.DMDFO_CENTER,GDI32.DMDFO_STRETCHdmColor– for printer devices onlydmDuplex– for printer devices onlydmYResolution– for printer devices onlydmTTOption– for printer devices onlydmCollate– for printer devices onlydmFormName– for printer devices onlydmLogPixels– the number of pixels per logical inchdmBitsPerPel– specifies the color resolution, in bits per pixel, of the display device (for example: 4 bits for 16 colors, 8 bits for 256 colors, or 16 bits for 65,536 colors)dmPelsWidth– specifies the width, in pixels, of the visible device surfacedmPelsHeight– specifies the height, in pixels, of the visible device surfacedmDisplayFlags– specifies the device's display mode, one or more of:GDI32.DM_INTERLACED,GDI32.DMDISPLAYFLAGS_TEXTMODEdmNup– for printer devices onlydmDisplayFrequency– specifies the frequency, in hertz (cycles per second), of the display device in a particular mode. This value is also known as the display device's vertical refresh rate.When you call the
User32.EnumDisplaySettingsEx(java.nio.ByteBuffer, int, org.lwjgl.system.windows.DEVMODE, int)function, thedmDisplayFrequencymember may return with the value 0 or 1. These values represent the display hardware's default refresh rate. This default rate is typically set by switches on a display card or computer motherboard, or by a configuration program that does not use display functions such asChangeDisplaySettingsEx.dmICMMethod– for printer devices onlydmICMIntent– for printer devices onlydmMediaType– for printer devices onlydmDitherType– for printer devices onlydmReserved1– not used; must be zerodmReserved2– not used; must be zerodmPanningWidth– this member must be zerodmPanningHeight– this member must be zero
Layout
struct DEVMODE { TCHAR[32] dmDeviceName; WORD dmSpecVersion; WORD dmDriverVersion; WORD dmSize; WORD dmDriverExtra; DWORD dmFields; union { struct { short dmOrientation; short dmPaperSize; short dmPaperLength; short dmPaperWidth; short dmScale; short dmCopies; short dmDefaultSource; short dmPrintQuality; }; struct {POINTLdmPosition; DWORD dmDisplayOrientation; DWORD dmDisplayFixedOutput; }; }; short dmColor; short dmDuplex; short dmYResolution; short dmTTOption; short dmCollate; TCHAR[32] dmFormName; WORD dmLogPixels; DWORD dmBitsPerPel; DWORD dmPelsWidth; DWORD dmPelsHeight; union { DWORD dmDisplayFlags; DWORD dmNup; }; DWORD dmDisplayFrequency; DWORD dmICMMethod; DWORD dmICMIntent; DWORD dmMediaType; DWORD dmDitherType; DWORD dmReserved1; DWORD dmReserved2; DWORD dmPanningWidth; DWORD dmPanningHeight; }
-
-
Nested Class Summary
Nested Classes Modifier and Type Class and Description static classDEVMODE.BufferAn array ofDEVMODEstructs.-
Nested classes/interfaces inherited from interface org.lwjgl.system.Pointer
Pointer.Default
-
-
Field Summary
Fields Modifier and Type Field and Description static intSIZEOFThe struct size in bytes.-
Fields inherited from interface org.lwjgl.system.Pointer
POINTER_SHIFT, POINTER_SIZE
-
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method and Description static DEVMODEcalloc()static DEVMODE.Buffercalloc(int capacity)Returns a newDEVMODE.Bufferinstance allocated withmemCalloc.static DEVMODEcallocStack()Returns a newDEVMODEinstance allocated on the thread-localMemoryStackand initializes all its bits to zero.static DEVMODE.BuffercallocStack(int capacity)Returns a newDEVMODE.Bufferinstance allocated on the thread-localMemoryStackand initializes all its bits to zero.static DEVMODE.BuffercallocStack(int capacity, MemoryStack stack)Returns a newDEVMODE.Bufferinstance allocated on the specifiedMemoryStackand initializes all its bits to zero.static DEVMODEcallocStack(MemoryStack stack)Returns a newDEVMODEinstance allocated on the specifiedMemoryStackand initializes all its bits to zero.static DEVMODEcreate()Returns a newDEVMODEinstance allocated withBufferUtils.static DEVMODE.Buffercreate(int capacity)Returns a newDEVMODE.Bufferinstance allocated withBufferUtils.static DEVMODEcreate(long address)static DEVMODE.Buffercreate(long address, int capacity)Create aDEVMODE.Bufferinstance at the specified memory.intdmBitsPerPel()Returns the value of thedmBitsPerPelfield.shortdmCollate()Returns the value of thedmCollatefield.shortdmColor()Returns the value of thedmColorfield.shortdmCopies()Returns the value of thedmCopiesfield.shortdmDefaultSource()Returns the value of thedmDefaultSourcefield.java.nio.ByteBufferdmDeviceName()Returns aByteBufferview of thedmDeviceNamefield.java.lang.StringdmDeviceNameString()Decodes the null-terminated string stored in thedmDeviceNamefield.intdmDisplayFixedOutput()Returns the value of thedmDisplayFixedOutputfield.intdmDisplayFlags()Returns the value of thedmDisplayFlagsfield.intdmDisplayFrequency()Returns the value of thedmDisplayFrequencyfield.intdmDisplayOrientation()Returns the value of thedmDisplayOrientationfield.intdmDitherType()Returns the value of thedmDitherTypefield.shortdmDriverExtra()Returns the value of thedmDriverExtrafield.DEVMODEdmDriverExtra(short value)Sets the specified value to thedmDriverExtrafield.shortdmDriverVersion()Returns the value of thedmDriverVersionfield.shortdmDuplex()Returns the value of thedmDuplexfield.intdmFields()Returns the value of thedmFieldsfield.java.nio.ByteBufferdmFormName()Returns aByteBufferview of thedmFormNamefield.java.lang.StringdmFormNameString()Decodes the null-terminated string stored in thedmFormNamefield.intdmICMIntent()Returns the value of thedmICMIntentfield.intdmICMMethod()Returns the value of thedmICMMethodfield.shortdmLogPixels()Returns the value of thedmLogPixelsfield.intdmMediaType()Returns the value of thedmMediaTypefield.intdmNup()Returns the value of thedmNupfield.shortdmOrientation()Returns the value of thedmOrientationfield.intdmPanningHeight()Returns the value of thedmPanningHeightfield.intdmPanningWidth()Returns the value of thedmPanningWidthfield.shortdmPaperLength()Returns the value of thedmPaperLengthfield.shortdmPaperSize()Returns the value of thedmPaperSizefield.shortdmPaperWidth()Returns the value of thedmPaperWidthfield.intdmPelsHeight()Returns the value of thedmPelsHeightfield.intdmPelsWidth()Returns the value of thedmPelsWidthfield.POINTLdmPosition()Returns aPOINTLview of thedmPositionfield.shortdmPrintQuality()Returns the value of thedmPrintQualityfield.intdmReserved1()Returns the value of thedmReserved1field.intdmReserved2()Returns the value of thedmReserved2field.shortdmScale()Returns the value of thedmScalefield.shortdmSize()Returns the value of thedmSizefield.DEVMODEdmSize(short value)Sets the specified value to thedmSizefield.shortdmSpecVersion()Returns the value of thedmSpecVersionfield.DEVMODEdmSpecVersion(short value)Sets the specified value to thedmSpecVersionfield.shortdmTTOption()Returns the value of thedmTTOptionfield.shortdmYResolution()Returns the value of thedmYResolutionfield.static DEVMODEmalloc()static DEVMODE.Buffermalloc(int capacity)Returns a newDEVMODE.Bufferinstance allocated withmemAlloc.static DEVMODEmallocStack()Returns a newDEVMODEinstance allocated on the thread-localMemoryStack.static DEVMODE.BuffermallocStack(int capacity)Returns a newDEVMODE.Bufferinstance allocated on the thread-localMemoryStack.static DEVMODE.BuffermallocStack(int capacity, MemoryStack stack)Returns a newDEVMODE.Bufferinstance allocated on the specifiedMemoryStack.static DEVMODEmallocStack(MemoryStack stack)Returns a newDEVMODEinstance allocated on the specifiedMemoryStack.DEVMODEnset(long struct)Unsafe version ofset.DEVMODEset(DEVMODE src)Copies the specified struct data to this struct.intsizeof()Returns thesizeof(struct).-
Methods inherited from class org.lwjgl.system.Pointer.Default
address, equals, hashCode, toString
-
Methods inherited from interface org.lwjgl.system.NativeResource
close
-
-
-
-
Constructor Detail
-
DEVMODE
public DEVMODE(java.nio.ByteBuffer container)
Creates aDEVMODEinstance at the current position of the specifiedByteBuffercontainer. Changes to the buffer's content will be visible to the struct instance and vice versa.The created instance holds a strong reference to the container object.
-
-
Method Detail
-
sizeof
public int sizeof()
Description copied from class:StructReturns thesizeof(struct).
-
dmDeviceName
public java.nio.ByteBuffer dmDeviceName()
Returns aByteBufferview of thedmDeviceNamefield.
-
dmDeviceNameString
public java.lang.String dmDeviceNameString()
Decodes the null-terminated string stored in thedmDeviceNamefield.
-
dmSpecVersion
public short dmSpecVersion()
Returns the value of thedmSpecVersionfield.
-
dmDriverVersion
public short dmDriverVersion()
Returns the value of thedmDriverVersionfield.
-
dmSize
public short dmSize()
Returns the value of thedmSizefield.
-
dmDriverExtra
public short dmDriverExtra()
Returns the value of thedmDriverExtrafield.
-
dmFields
public int dmFields()
Returns the value of thedmFieldsfield.
-
dmOrientation
public short dmOrientation()
Returns the value of thedmOrientationfield.
-
dmPaperSize
public short dmPaperSize()
Returns the value of thedmPaperSizefield.
-
dmPaperLength
public short dmPaperLength()
Returns the value of thedmPaperLengthfield.
-
dmPaperWidth
public short dmPaperWidth()
Returns the value of thedmPaperWidthfield.
-
dmScale
public short dmScale()
Returns the value of thedmScalefield.
-
dmCopies
public short dmCopies()
Returns the value of thedmCopiesfield.
-
dmDefaultSource
public short dmDefaultSource()
Returns the value of thedmDefaultSourcefield.
-
dmPrintQuality
public short dmPrintQuality()
Returns the value of thedmPrintQualityfield.
-
dmDisplayOrientation
public int dmDisplayOrientation()
Returns the value of thedmDisplayOrientationfield.
-
dmDisplayFixedOutput
public int dmDisplayFixedOutput()
Returns the value of thedmDisplayFixedOutputfield.
-
dmColor
public short dmColor()
Returns the value of thedmColorfield.
-
dmDuplex
public short dmDuplex()
Returns the value of thedmDuplexfield.
-
dmYResolution
public short dmYResolution()
Returns the value of thedmYResolutionfield.
-
dmTTOption
public short dmTTOption()
Returns the value of thedmTTOptionfield.
-
dmCollate
public short dmCollate()
Returns the value of thedmCollatefield.
-
dmFormName
public java.nio.ByteBuffer dmFormName()
Returns aByteBufferview of thedmFormNamefield.
-
dmFormNameString
public java.lang.String dmFormNameString()
Decodes the null-terminated string stored in thedmFormNamefield.
-
dmLogPixels
public short dmLogPixels()
Returns the value of thedmLogPixelsfield.
-
dmBitsPerPel
public int dmBitsPerPel()
Returns the value of thedmBitsPerPelfield.
-
dmPelsWidth
public int dmPelsWidth()
Returns the value of thedmPelsWidthfield.
-
dmPelsHeight
public int dmPelsHeight()
Returns the value of thedmPelsHeightfield.
-
dmDisplayFlags
public int dmDisplayFlags()
Returns the value of thedmDisplayFlagsfield.
-
dmNup
public int dmNup()
Returns the value of thedmNupfield.
-
dmDisplayFrequency
public int dmDisplayFrequency()
Returns the value of thedmDisplayFrequencyfield.
-
dmICMMethod
public int dmICMMethod()
Returns the value of thedmICMMethodfield.
-
dmICMIntent
public int dmICMIntent()
Returns the value of thedmICMIntentfield.
-
dmMediaType
public int dmMediaType()
Returns the value of thedmMediaTypefield.
-
dmDitherType
public int dmDitherType()
Returns the value of thedmDitherTypefield.
-
dmReserved1
public int dmReserved1()
Returns the value of thedmReserved1field.
-
dmReserved2
public int dmReserved2()
Returns the value of thedmReserved2field.
-
dmPanningWidth
public int dmPanningWidth()
Returns the value of thedmPanningWidthfield.
-
dmPanningHeight
public int dmPanningHeight()
Returns the value of thedmPanningHeightfield.
-
dmSpecVersion
public DEVMODE dmSpecVersion(short value)
Sets the specified value to thedmSpecVersionfield.
-
dmSize
public DEVMODE dmSize(short value)
Sets the specified value to thedmSizefield.
-
dmDriverExtra
public DEVMODE dmDriverExtra(short value)
Sets the specified value to thedmDriverExtrafield.
-
set
public DEVMODE set(DEVMODE src)
Copies the specified struct data to this struct.- Parameters:
src- the source struct- Returns:
- this struct
-
malloc
public static DEVMODE malloc()
-
calloc
public static DEVMODE calloc()
-
create
public static DEVMODE create()
Returns a newDEVMODEinstance allocated withBufferUtils.
-
create
public static DEVMODE create(long address)
-
malloc
public static DEVMODE.Buffer malloc(int capacity)
Returns a newDEVMODE.Bufferinstance allocated withmemAlloc. The instance must be explicitly freed.- Parameters:
capacity- the buffer capacity
-
calloc
public static DEVMODE.Buffer calloc(int capacity)
Returns a newDEVMODE.Bufferinstance allocated withmemCalloc. The instance must be explicitly freed.- Parameters:
capacity- the buffer capacity
-
create
public static DEVMODE.Buffer create(int capacity)
Returns a newDEVMODE.Bufferinstance allocated withBufferUtils.- Parameters:
capacity- the buffer capacity
-
create
public static DEVMODE.Buffer create(long address, int capacity)
Create aDEVMODE.Bufferinstance at the specified memory.- Parameters:
address- the memory addresscapacity- the buffer capacity
-
mallocStack
public static DEVMODE mallocStack()
Returns a newDEVMODEinstance allocated on the thread-localMemoryStack.
-
callocStack
public static DEVMODE callocStack()
Returns a newDEVMODEinstance allocated on the thread-localMemoryStackand initializes all its bits to zero.
-
mallocStack
public static DEVMODE mallocStack(MemoryStack stack)
Returns a newDEVMODEinstance allocated on the specifiedMemoryStack.- Parameters:
stack- the stack from which to allocate
-
callocStack
public static DEVMODE callocStack(MemoryStack stack)
Returns a newDEVMODEinstance allocated on the specifiedMemoryStackand initializes all its bits to zero.- Parameters:
stack- the stack from which to allocate
-
mallocStack
public static DEVMODE.Buffer mallocStack(int capacity)
Returns a newDEVMODE.Bufferinstance allocated on the thread-localMemoryStack.- Parameters:
capacity- the buffer capacity
-
callocStack
public static DEVMODE.Buffer callocStack(int capacity)
Returns a newDEVMODE.Bufferinstance allocated on the thread-localMemoryStackand initializes all its bits to zero.- Parameters:
capacity- the buffer capacity
-
mallocStack
public static DEVMODE.Buffer mallocStack(int capacity, MemoryStack stack)
Returns a newDEVMODE.Bufferinstance allocated on the specifiedMemoryStack.- Parameters:
stack- the stack from which to allocatecapacity- the buffer capacity
-
callocStack
public static DEVMODE.Buffer callocStack(int capacity, MemoryStack stack)
Returns a newDEVMODE.Bufferinstance allocated on the specifiedMemoryStackand initializes all its bits to zero.- Parameters:
stack- the stack from which to allocatecapacity- the buffer capacity
-
-