/// <summary>
/// Returns one packet of Wintab data from the packet queue.
/// </summary>
/// <param name="hCtx_I">Wintab context to be used when asking for the data</param>
/// <param name="pktID_I">Identifier for the tablet event packet to return.</param>
/// <returns>Returns a data packet with non-null context if successful.</returns>
public WintabPacket GetDataPacket(UInt32 hCtx_I, UInt32 pktID_I)
{
IntPtr buf = CMemUtils.AllocUnmanagedBuf(Marshal.SizeOf(typeof(WintabPacket)));
WintabPacket packet = new WintabPacket();
if (pktID_I == 0)
{
throw new Exception("GetDataPacket - invalid pktID");
}
CheckForValidHCTX("GetDataPacket");
if (CWintabFuncs.WTPacket(hCtx_I, pktID_I, buf))
{
packet = (WintabPacket)Marshal.PtrToStructure(buf, typeof(WintabPacket));
}
else
{
//
// If fails, make sure context is zero.
//
packet.pkContext = 0;
}
/**
* PERFORMANCE FIX: without this line, the memory consume of .NET apps increase
* exponentially when the PEN is used for long time (or worse when the pen is leaved alone on the tablet screen)
* causing the app to crash now or later...
* Author: Alessandro del Gobbo ([email protected])
*/
CMemUtils.FreeUnmanagedBuf(buf);
return(packet);
}
/// <summary>
/// Returns a string containing device name.
/// </summary>
/// <returns></returns>
public static String GetDeviceInfo()
{
string devInfo = null;
IntPtr buf = CMemUtils.AllocUnmanagedBuf(MAX_STRING_SIZE);
try
{
int size = (int)CWintabFuncs.WTInfo(
(uint)EWTICategoryIndex.WTI_DEVICES,
(uint)EWTIDevicesIndex.DVC_NAME, buf);
if (size < 1)
{
throw new Exception("GetDeviceInfo returned empty string.");
}
// Strip off final null character before marshalling.
devInfo = CMemUtils.MarshalUnmanagedString(buf, size - 2);
}
finally
{
CMemUtils.FreeUnmanagedBuf(buf);
}
return(devInfo);
}
/// <summary>
/// Returns extension index tag for given tag, if possible.
/// </summary>
/// <param name="tag_I">type of extension being searched for</param>
/// <returns>0xFFFFFFFF on error</returns>
public static UInt32 FindWTExtensionIndex(EWTXExtensionTag tag_I)
{
UInt32 thisTag = 0;
UInt32 extIndex = 0xFFFFFFFF;
IntPtr buf = CMemUtils.AllocUnmanagedBuf(thisTag);
for (Int32 loopIdx = 0, size = -1; size != 0; loopIdx++)
{
size = (int)CWintabFuncs.WTInfoA(
(uint)EWTICategoryIndex.WTI_EXTENSIONS + (UInt32)loopIdx,
(uint)EWTIExtensionIndex.EXT_TAG, buf);
if (size > 0)
{
thisTag = CMemUtils.MarshalUnmanagedBuf <UInt32>(buf, size);
if ((EWTXExtensionTag)thisTag == tag_I)
{
extIndex = (UInt32)loopIdx;
break;
}
}
}
CMemUtils.FreeUnmanagedBuf(buf);
return(extIndex);
}
/// <summary>
/// Return the extension mask for the given tag.
/// </summary>
/// <param name="tag_I">type of extension being searched for</param>
/// <returns>0xFFFFFFFF on error</returns>
public static UInt32 GetWTExtensionMask(EWTXExtensionTag tag_I)
{
UInt32 extMask = 0;
IntPtr buf = CMemUtils.AllocUnmanagedBuf(extMask);
try
{
UInt32 extIndex = FindWTExtensionIndex(tag_I);
// Supported if extIndex != -1
if (extIndex != 0xFFFFFFFF)
{
int size = (int)CWintabFuncs.WTInfoA(
(uint)EWTICategoryIndex.WTI_EXTENSIONS + (uint)extIndex,
(uint)EWTIExtensionIndex.EXT_MASK, buf);
extMask = (UInt32)CMemUtils.MarshalUnmanagedBuf <UInt32>(buf, size);
}
}
catch (Exception ex)
{
MessageBox.Show("FAILED GetWTExtensionMask: " + ex.ToString());
}
CMemUtils.FreeUnmanagedBuf(buf);
return(extMask);
}
/// <summary>
/// Marshal unmanaged Extension data packets into managed WintabPacketExt data.
/// </summary>
/// <param name="numPkts_I">number of packets to marshal</param>
/// <param name="buf_I">pointer to unmanaged heap memory containing data packets</param>
/// <returns></returns>
public static WintabPacketExt[] MarshalDataExtPackets(UInt32 numPkts_I, IntPtr buf_I)
{
WintabPacketExt[] packets = new WintabPacketExt[numPkts_I];
if (numPkts_I == 0 || buf_I == IntPtr.Zero)
{
return(null);
}
// Marshal each WintabPacketExt in the array separately.
// This is "necessary" because none of the other ways I tried to marshal
// seemed to work. It's ugly, but it works.
int pktSize = Marshal.SizeOf(new WintabPacketExt());
Byte[] byteArray = new Byte[numPkts_I * pktSize];
Marshal.Copy(buf_I, byteArray, 0, (int)numPkts_I * pktSize);
Byte[] byteArray2 = new Byte[pktSize];
for (int pktsIdx = 0; pktsIdx < numPkts_I; pktsIdx++)
{
for (int idx = 0; idx < pktSize; idx++)
{
byteArray2[idx] = byteArray[(pktsIdx * pktSize) + idx];
}
IntPtr tmp = CMemUtils.AllocUnmanagedBuf(pktSize);
Marshal.Copy(byteArray2, 0, tmp, pktSize);
packets[pktsIdx] = CMemUtils.MarshalUnmanagedBuf <WintabPacketExt>(tmp, pktSize);
}
return(packets);
}
/// <summary>
/// Returns a 3-element array describing the tablet's rotation range and resolution capabilities
/// </summary>
/// <returns></returns>
public static WintabAxisArray GetDeviceRotation(out bool rotationSupported_O)
{
WintabAxisArray axisArray = new WintabAxisArray();
rotationSupported_O = false;
IntPtr buf = CMemUtils.AllocUnmanagedBuf(axisArray);
try
{
int size = (int)CWintabFuncs.WTInfo(
(uint)EWTICategoryIndex.WTI_DEVICES,
(uint)EWTIDevicesIndex.DVC_ROTATION, buf);
// If size == 0, then returns a zeroed struct.
axisArray = CMemUtils.MarshalUnmanagedBuf <WintabAxisArray>(buf, size);
rotationSupported_O = (axisArray.array[0].axResolution != 0 && axisArray.array[1].axResolution != 0);
}
catch (Exception ex)
{
MessageBox.Show("FAILED GetDeviceRotation: " + ex.ToString());
}
CMemUtils.FreeUnmanagedBuf(buf);
return(axisArray);
}
/// <summary>
/// Returns a string containing the name of the selected stylus.
/// </summary>
/// <param name="index_I">indicates stylus type</param>
/// <returns></returns>
public static string GetStylusName(EWTICursorNameIndex index_I)
{
string stylusName = null;
IntPtr buf = CMemUtils.AllocUnmanagedBuf(MAX_STRING_SIZE);
try
{
int size = (int)CWintabFuncs.WTInfo(
(uint)index_I,
(uint)EWTICursorsIndex.CSR_NAME, buf);
if (size < 1)
{
throw new Exception("GetStylusName returned empty string.");
}
// Strip off final null character before marshalling.
stylusName = CMemUtils.MarshalUnmanagedString(buf, size - 1);
}
catch (Exception ex)
{
MessageBox.Show("FAILED GetDeviceInfo: " + ex.ToString());
}
CMemUtils.FreeUnmanagedBuf(buf);
return(stylusName);
}
/// <summary>
/// Returns one packet of Wintab data from the packet queue.
/// </summary>
/// <param name="hCtx_I">Wintab context to be used when asking for the data</param>
/// <param name="pktID_I">Identifier for the tablet event packet to return.</param>
/// <returns>Returns a data packet with non-null context if successful.</returns>
public WintabPacket GetDataPacket(UInt32 hCtx_I, UInt32 pktID_I)
{
IntPtr buf = CMemUtils.AllocUnmanagedBuf(Marshal.SizeOf(typeof(WintabPacket)));
WintabPacket packet = new WintabPacket();
if (pktID_I == 0)
{
throw new Exception("GetDataPacket - invalid pktID");
}
CheckForValidHCTX("GetDataPacket");
if (CWintabFuncs.WTPacket(hCtx_I, pktID_I, buf))
{
packet = (WintabPacket)Marshal.PtrToStructure(buf, typeof(WintabPacket));
}
else
{
//
// If fails, make sure context is zero.
//
packet.pkContext = 0;
}
return(packet);
}
/// <summary>
/// Return the extension mask for the given tag.
/// </summary>
/// <param name="tag_I">type of extension being searched for</param>
/// <returns>0xFFFFFFFF on error</returns>
public static UInt32 GetWTExtensionMask(EWTXExtensionTag tag_I)
{
UInt32 extMask = 0;
IntPtr buf = CMemUtils.AllocUnmanagedBuf(extMask);
try
{
UInt32 extIndex = FindWTExtensionIndex(tag_I);
// Supported if extIndex != -1
if (extIndex != 0xFFFFFFFF)
{
int size = (int)CWintabFuncs.WTInfo(
(uint)EWTICategoryIndex.WTI_EXTENSIONS + (uint)extIndex,
(uint)EWTIExtensionIndex.EXT_MASK, buf);
extMask = (UInt32)CMemUtils.MarshalUnmanagedBuf <UInt32>(buf, size);
}
}
finally
{
CMemUtils.FreeUnmanagedBuf(buf);
}
return(extMask);
}
/// <summary>
/// Sets an extension control property image (if supported by tablet).
/// </summary>
/// <param name="context_I">wintab context</param>
/// <param name="extTagIndex_I">which extension tag we're setting</param>
/// <param name="tabletIndex_I">index of the tablet being set</param>
/// <param name="controlIndex_I">the index of the control being set</param>
/// <param name="functionIndex_I">the index of the control function being set</param>
/// <param name="propertyID_I">ID of the property being set</param>
/// <param name="value_I">value of the property being set (a string)</param>
/// <returns>true if successful</returns>
public static bool ControlPropertySetImage(
HCTX context_I,
byte extTagIndex_I,
byte tabletIndex_I,
byte controlIndex_I,
byte functionIndex_I,
ushort propertyID_I,
String imageFilePath_I
)
{
bool retStatus = false;
WTExtensionImageProperty extProperty = new WTExtensionImageProperty();
IntPtr buf = CMemUtils.AllocUnmanagedBuf(extProperty);
try
{
byte[] imageBytes = null;
System.Drawing.Image newImage = Image.FromFile(imageFilePath_I);
if (newImage == null)
{
MessageBox.Show("Oops - couldn't find/read image: " + imageFilePath_I);
return(false);
}
using (MemoryStream ms = new MemoryStream())
{
newImage.Save(ms, System.Drawing.Imaging.ImageFormat.Png);
imageBytes = ms.ToArray();
}
extProperty.extBase.version = 0;
extProperty.extBase.tabletIndex = tabletIndex_I;
extProperty.extBase.controlIndex = controlIndex_I;
extProperty.extBase.functionIndex = functionIndex_I;
extProperty.extBase.propertyID = propertyID_I;
extProperty.extBase.reserved = 0;
extProperty.extBase.dataSize = (uint)imageBytes.Length;
extProperty.data = new byte[WTExtensionsGlobal.WTExtensionPropertyImageMaxDataBytes];
// Send image as an array of bytes.
System.Buffer.BlockCopy(imageBytes, 0, extProperty.data, 0, (int)extProperty.extBase.dataSize);
Marshal.StructureToPtr(extProperty, buf, false);
retStatus = CWintabFuncs.WTExtSet((UInt32)context_I, (UInt32)extTagIndex_I, buf);
}
catch (Exception ex)
{
MessageBox.Show(ex.ToString());
}
CMemUtils.FreeUnmanagedBuf(buf);
return(retStatus);
}
/// <summary>
/// Helper function to get digitizing or system default context.
/// </summary>
/// <param name="contextType_I">Use WTI_DEFCONTEXT for digital context or WTI_DEFSYSCTX for system context</param>
/// <returns>Returns the default context or null on error.</returns>
private static CWintabContext GetDefaultContext(EWTICategoryIndex contextIndex_I)
{
CWintabContext context = new CWintabContext();
IntPtr buf = CMemUtils.AllocUnmanagedBuf(context.LogContext);
try
{
int size = (int)CWintabFuncs.WTInfo((uint)contextIndex_I, 0, buf);
context.LogContext = CMemUtils.MarshalUnmanagedBuf <WintabLogContext>(buf, size);
}
finally
{
CMemUtils.FreeUnmanagedBuf(buf);
}
return(context);
}
/// <summary>
/// Returns one packet of WintabPacketExt data from the packet queue.
/// </summary>
/// <param name="hCtx_I">Wintab context to be used when asking for the data</param>
/// <param name="pktID_I">Identifier for the tablet event packet to return.</param>
/// <returns>Returns a data packet with non-null context if successful.</returns>
public WintabPacketExt GetDataPacketExt(UInt32 hCtx_I, UInt32 pktID_I)
{
int size = (int)(Marshal.SizeOf(new WintabPacketExt()));
IntPtr buf = CMemUtils.AllocUnmanagedBuf(size);
WintabPacketExt[] packets = null;
try
{
bool status = false;
if (pktID_I == 0)
{
throw new Exception("GetDataPacket - invalid pktID");
}
CheckForValidHCTX("GetDataPacket");
status = CWintabFuncs.WTPacket(hCtx_I, pktID_I, buf);
if (status)
{
packets = CMemUtils.MarshalDataExtPackets(1, buf);
}
else
{
// If fails, make sure context is zero.
packets[0].pkBase.nContext = 0;
}
}
catch (Exception ex)
{
MessageBox.Show("FAILED GetDataPacketExt: " + ex.ToString());
}
/**
* PERFORMANCE FIX: without this line, the memory consume of .NET apps increase
* exponentially when the PEN is used for long time (or worse when the pen is leaved alone on the tablet screen)
* causing the app to crash now or later...
* Author: Alessandro del Gobbo ([email protected])
*/
CMemUtils.FreeUnmanagedBuf(buf);
return(packets[0]);
}
/// <summary>
/// Get a property value from an extension.
/// </summary>
/// <param name="context_I">Wintab context</param>
/// <param name="extTagIndex_I">extension index tag</param>
/// <param name="tabletIndex_I">tablet index</param>
/// <param name="controlIndex_I">control index on the tablet</param>
/// <param name="functionIndex_I">function index on the control</param>
/// <param name="propertyID_I">ID of the property requested</param>
/// <param name="result_O">value of the property requested</param>
/// <returns>true if property obtained</returns>
public static bool ControlPropertyGet(
HCTX context_I,
byte extTagIndex_I,
byte tabletIndex_I,
byte controlIndex_I,
byte functionIndex_I,
ushort propertyID_I,
ref UInt32 result_O
)
{
bool retStatus = false;
WTExtensionProperty extProperty = new WTExtensionProperty();
IntPtr buf = CMemUtils.AllocUnmanagedBuf(extProperty);
extProperty.extBase.version = 0;
extProperty.extBase.tabletIndex = tabletIndex_I;
extProperty.extBase.controlIndex = controlIndex_I;
extProperty.extBase.functionIndex = functionIndex_I;
extProperty.extBase.propertyID = propertyID_I;
extProperty.extBase.reserved = 0;
extProperty.extBase.dataSize = (uint)System.Runtime.InteropServices.Marshal.SizeOf(result_O);
Marshal.StructureToPtr(extProperty, buf, false);
try
{
bool status = CWintabFuncs.WTExtGet((UInt32)context_I, (UInt32)extTagIndex_I, buf);
if (status)
{
WTExtensionProperty retProp = (WTExtensionProperty)Marshal.PtrToStructure(buf, typeof(WTExtensionProperty));
result_O = retProp.data[0];
retStatus = true;
}
}
catch (Exception ex)
{
MessageBox.Show("FAILED ControlPropertyGet: " + ex.ToString());
}
CMemUtils.FreeUnmanagedBuf(buf);
return(retStatus);
}
/// <summary>
/// Sets an extension control property string.
/// </summary>
/// <param name="context_I">wintab context</param>
/// <param name="extTagIndex_I">which extension tag we're setting</param>
/// <param name="tabletIndex_I">index of the tablet being set</param>
/// <param name="controlIndex_I">the index of the control being set</param>
/// <param name="functionIndex_I">the index of the control function being set</param>
/// <param name="propertyID_I">ID of the property being set</param>
/// <param name="value_I">value of the property being set (a string)</param>
/// <returns>true if successful</returns>
public static bool ControlPropertySet(
HCTX context_I,
byte extTagIndex_I,
byte tabletIndex_I,
byte controlIndex_I,
byte functionIndex_I,
ushort propertyID_I,
String value_I
)
{
bool retStatus = false;
WTExtensionProperty extProperty = new WTExtensionProperty();
IntPtr buf = CMemUtils.AllocUnmanagedBuf(extProperty);
try
{
// Convert unicode string value_I to UTF8-encoded bytes
byte[] utf8Bytes = System.Text.Encoding.Convert(Encoding.Unicode, Encoding.UTF8, Encoding.Unicode.GetBytes(value_I));
extProperty.extBase.version = 0;
extProperty.extBase.tabletIndex = tabletIndex_I;
extProperty.extBase.controlIndex = controlIndex_I;
extProperty.extBase.functionIndex = functionIndex_I;
extProperty.extBase.propertyID = propertyID_I;
extProperty.extBase.reserved = 0;
extProperty.extBase.dataSize = (uint)utf8Bytes.Length;
extProperty.data = new byte[WTExtensionsGlobal.WTExtensionPropertyMaxDataBytes];
// Send input value as an array of UTF8-encoded bytes.
System.Buffer.BlockCopy(utf8Bytes, 0, extProperty.data, 0, (int)extProperty.extBase.dataSize);
Marshal.StructureToPtr(extProperty, buf, false);
retStatus = CWintabFuncs.WTExtSet((UInt32)context_I, (UInt32)extTagIndex_I, buf);
}
catch (Exception ex)
{
MessageBox.Show(ex.ToString());
}
CMemUtils.FreeUnmanagedBuf(buf);
return(retStatus);
}
/// <summary>
/// Sets an extension control property value.
/// </summary>
/// <param name="context_I">wintab context</param>
/// <param name="extTagIndex_I">which extension tag we're setting</param>
/// <param name="tabletIndex_I">index of the tablet being set</param>
/// <param name="controlIndex_I">the index of the control being set</param>
/// <param name="functionIndex_I">the index of the control function being set</param>
/// <param name="propertyID_I">ID of the property being set</param>
/// <param name="value_I">value of the property being set</param>
/// <returns>true if successful</returns>
public static bool ControlPropertySet(
HCTX context_I,
byte extTagIndex_I,
byte tabletIndex_I,
byte controlIndex_I,
byte functionIndex_I,
ushort propertyID_I,
UInt32 value_I
)
{
bool retStatus = false;
WTExtensionProperty extProperty = new WTExtensionProperty();
IntPtr buf = CMemUtils.AllocUnmanagedBuf(extProperty);
try
{
byte[] valueBytes = BitConverter.GetBytes(value_I);
extProperty.extBase.version = 0;
extProperty.extBase.tabletIndex = tabletIndex_I;
extProperty.extBase.controlIndex = controlIndex_I;
extProperty.extBase.functionIndex = functionIndex_I;
extProperty.extBase.propertyID = propertyID_I;
extProperty.extBase.reserved = 0;
extProperty.extBase.dataSize = (uint)System.Runtime.InteropServices.Marshal.SizeOf(value_I);
extProperty.data = new byte[WTExtensionsGlobal.WTExtensionPropertyMaxDataBytes];
// Send input value as an array of bytes.
System.Buffer.BlockCopy(valueBytes, 0, extProperty.data, 0, (int)extProperty.extBase.dataSize);
Marshal.StructureToPtr(extProperty, buf, false);
retStatus = CWintabFuncs.WTExtSet((UInt32)context_I, (UInt32)extTagIndex_I, buf);
}
catch (Exception ex)
{
MessageBox.Show(ex.ToString());
}
CMemUtils.FreeUnmanagedBuf(buf);
return(retStatus);
}
public static WintabPacket[] MarshalDataPackets(UInt32 numPkts_I, IntPtr buf_I)
{
if (numPkts_I == 0 || buf_I == IntPtr.Zero)
{
return(null);
}
WintabPacket[] packets = new WintabPacket[numPkts_I];
//
// Marshal each WintabPacket in the array separately.
// This is "necessary" because none of the other ways I tried to marshal
// seemed to work. It's ugly, but it works.
//
int pktSize = Marshal.SizeOf(new WintabPacket());
Byte[] byteArray = new Byte[numPkts_I * pktSize];
Marshal.Copy(buf_I, byteArray, 0, (int)numPkts_I * pktSize);
Byte[] byteArray2 = new Byte[pktSize];
for (int pktsIdx = 0; pktsIdx < numPkts_I; pktsIdx++)
{
#if TRACE_RAW_BYTES
// Trace out the raw data bytes for each packet using a hex formatter.
Debug.Write("Packet: [" + Convert.ToString(pktsIdx) + "] ");
for (int idx = 0; idx < pktSize; idx++)
{
byteArray2[idx] = byteArray[(pktsIdx * pktSize) + idx];
Debug.Write(String.Format("{0,3:X2}", byteArray2[idx]));
}
Debug.WriteLine("");
#endif //TRACE_RAW_BYTES
IntPtr tmp = CMemUtils.AllocUnmanagedBuf(pktSize);
Marshal.Copy(byteArray2, 0, tmp, pktSize);
packets[pktsIdx] = CMemUtils.MarshalUnmanagedBuf <WintabPacket>(tmp, pktSize);
}
return(packets);
}
/// <summary>
/// Returns the number of devices connected.
/// </summary>
/// <returns></returns>
public static UInt32 GetNumberOfDevices()
{
UInt32 numDevices = 0;
IntPtr buf = CMemUtils.AllocUnmanagedBuf(numDevices);
try
{
int size = (int)CWintabFuncs.WTInfo(
(uint)EWTICategoryIndex.WTI_INTERFACE,
(uint)EWTIInterfaceIndex.IFC_NDEVICES, buf);
numDevices = CMemUtils.MarshalUnmanagedBuf <UInt32>(buf, size);
}
finally
{
CMemUtils.FreeUnmanagedBuf(buf);
}
return(numDevices);
}
/// <summary>
/// Returns whether a stylus is currently connected to the active cursor.
/// </summary>
/// <returns></returns>
public static bool IsStylusActive()
{
bool isStylusActive = false;
IntPtr buf = CMemUtils.AllocUnmanagedBuf(isStylusActive);
try
{
int size = (int)CWintabFuncs.WTInfo(
(uint)EWTICategoryIndex.WTI_INTERFACE,
(uint)EWTIInterfaceIndex.IFC_NDEVICES, buf);
isStylusActive = CMemUtils.MarshalUnmanagedBuf <bool>(buf, size);
}
finally
{
CMemUtils.FreeUnmanagedBuf(buf);
}
return(isStylusActive);
}
/// <summary>
/// Returns the default device. If this value is -1, then it also known as a "virtual device".
/// </summary>
/// <returns></returns>
public static Int32 GetDefaultDeviceIndex()
{
Int32 devIndex = 0;
IntPtr buf = CMemUtils.AllocUnmanagedBuf(devIndex);
try
{
int size = (int)CWintabFuncs.WTInfo(
(uint)EWTICategoryIndex.WTI_DEFCONTEXT,
(uint)EWTIContextIndex.CTX_DEVICE, buf);
devIndex = CMemUtils.MarshalUnmanagedBuf <Int32>(buf, size);
}
finally
{
CMemUtils.FreeUnmanagedBuf(buf);
}
return(devIndex);
}
/// <summary>
/// Return the WintabAxis object for the specified dimension.
/// </summary>
/// <param name="dimension_I">Dimension to fetch (eg: x, y)</param>
/// <returns></returns>
public static WintabAxis GetTabletAxis(EAxisDimension dimension_I)
{
WintabAxis axis = new WintabAxis();
IntPtr buf = CMemUtils.AllocUnmanagedBuf(axis);
try
{
int size = (int)CWintabFuncs.WTInfo(
(uint)EWTICategoryIndex.WTI_DEVICES,
(uint)dimension_I, buf);
axis = CMemUtils.MarshalUnmanagedBuf <WintabAxis>(buf, size);
}
finally
{
CMemUtils.FreeUnmanagedBuf(buf);
}
return(axis);
}
/// <summary>
/// Helper function to get digitizing or system default context.
/// </summary>
/// <param name="contextType_I">Use WTI_DEFCONTEXT for digital context or WTI_DEFSYSCTX for system context</param>
/// <returns>Returns the default context or null on error.</returns>
private static CWintabContext GetDefaultContext(EWTICategoryIndex contextIndex_I)
{
CWintabContext context = new CWintabContext();
IntPtr buf = CMemUtils.AllocUnmanagedBuf(context.LogContext);
try
{
int size = (int)CWintabFuncs.WTInfoA((uint)contextIndex_I, 0, buf);
context.LogContext = CMemUtils.MarshalUnmanagedBuf <WintabLogContext>(buf, size);
}
catch (Exception ex)
{
MessageBox.Show("FAILED GetDefaultContext: " + ex.ToString());
}
CMemUtils.FreeUnmanagedBuf(buf);
return(context);
}
/// <summary>
/// Returns the WintabAxis object for specified device and dimension.
/// </summary>
/// <param name="devIndex_I">Device index (-1 = virtual device)</param>
/// <param name="dim_I">Dimension: AXIS_X, AXIS_Y or AXIS_Z</param>
/// <returns></returns>
public static WintabAxis GetDeviceAxis(Int32 devIndex_I, EAxisDimension dim_I)
{
WintabAxis axis = new WintabAxis();
IntPtr buf = CMemUtils.AllocUnmanagedBuf(axis);
try
{
int size = (int)CWintabFuncs.WTInfo(
(uint)(EWTICategoryIndex.WTI_DEVICES + devIndex_I),
(uint)dim_I, buf);
// If size == 0, then returns a zeroed struct.
axis = CMemUtils.MarshalUnmanagedBuf <WintabAxis>(buf, size);
}
finally
{
CMemUtils.FreeUnmanagedBuf(buf);
}
return(axis);
}
/// <summary>
/// Return the WintabAxis object for the specified dimension.
/// </summary>
/// <param name="dimension_I">Dimension to fetch (eg: x, y)</param>
/// <returns></returns>
public static WintabAxis GetTabletAxis(EAxisDimension dimension_I)
{
WintabAxis axis = new WintabAxis();
IntPtr buf = CMemUtils.AllocUnmanagedBuf(axis);
try
{
int size = (int)CWintabFuncs.WTInfoA(
(uint)EWTICategoryIndex.WTI_DEVICES,
(uint)dimension_I, buf);
axis = CMemUtils.MarshalUnmanagedBuf <WintabAxis>(buf, size);
}
catch (Exception ex)
{
MessageBox.Show("FAILED GetMaxPressure: " + ex.ToString());
}
CMemUtils.FreeUnmanagedBuf(buf);
return(axis);
}
/// <summary>
/// Returns whether a stylus is currently connected to the active cursor.
/// </summary>
/// <returns></returns>
public static bool IsStylusActive()
{
bool isStylusActive = false;
IntPtr buf = CMemUtils.AllocUnmanagedBuf(isStylusActive);
try
{
int size = (int)CWintabFuncs.WTInfoA(
(uint)EWTICategoryIndex.WTI_INTERFACE,
(uint)EWTIInterfaceIndex.IFC_NDEVICES, buf);
isStylusActive = CMemUtils.MarshalUnmanagedBuf <bool>(buf, size);
}
catch (Exception ex)
{
MessageBox.Show("FAILED GetNumberOfDevices: " + ex.ToString());
}
CMemUtils.FreeUnmanagedBuf(buf);
return(isStylusActive);
}
/// <summary>
/// Returns the number of devices connected.
/// </summary>
/// <returns></returns>
public static UInt32 GetNumberOfDevices()
{
UInt32 numDevices = 0;
IntPtr buf = CMemUtils.AllocUnmanagedBuf(numDevices);
try
{
int size = (int)CWintabFuncs.WTInfoA(
(uint)EWTICategoryIndex.WTI_INTERFACE,
(uint)EWTIInterfaceIndex.IFC_NDEVICES, buf);
numDevices = CMemUtils.MarshalUnmanagedBuf <UInt32>(buf, size);
}
catch (Exception ex)
{
MessageBox.Show("FAILED GetNumberOfDevices: " + ex.ToString());
}
CMemUtils.FreeUnmanagedBuf(buf);
return(numDevices);
}
/// <summary>
/// Returns the default device. If this value is -1, then it also known as a "virtual device".
/// </summary>
/// <returns></returns>
public static Int32 GetDefaultDeviceIndex()
{
Int32 devIndex = 0;
IntPtr buf = CMemUtils.AllocUnmanagedBuf(devIndex);
try
{
int size = (int)CWintabFuncs.WTInfoA(
(uint)EWTICategoryIndex.WTI_DEFCONTEXT,
(uint)EWTIContextIndex.CTX_DEVICE, buf);
devIndex = CMemUtils.MarshalUnmanagedBuf <Int32>(buf, size);
}
catch (Exception ex)
{
MessageBox.Show("FAILED GetDefaultDeviceIndex: " + ex.ToString());
}
CMemUtils.FreeUnmanagedBuf(buf);
return(devIndex);
}
/// <summary>
/// Returns one packet of WintabPacketExt data from the packet queue.
/// </summary>
/// <param name="hCtx_I">Wintab context to be used when asking for the data</param>
/// <param name="pktID_I">Identifier for the tablet event packet to return.</param>
/// <returns>Returns a data packet with non-null context if successful.</returns>
public WintabPacketExt GetDataPacketExt(HCTX hCtx_I, UInt32 pktID_I)
{
int size = (int)(Marshal.SizeOf(new WintabPacketExt()));
IntPtr buf = CMemUtils.AllocUnmanagedBuf(size);
WintabPacketExt[] packets = null;
try
{
bool status = false;
if (pktID_I == 0)
{
throw new Exception("GetDataPacket - invalid pktID");
}
CheckForValidHCTX("GetDataPacket");
status = CWintabFuncs.WTPacket(hCtx_I, pktID_I, buf);
if (status)
{
packets = CMemUtils.MarshalDataExtPackets(1, buf);
}
else
{
// If fails, make sure context is zero.
packets[0].pkBase.nContext = HCTX.Zero;
}
}
catch (Exception ex)
{
MessageBox.Show("FAILED GetDataPacketExt: " + ex.ToString());
}
CMemUtils.FreeUnmanagedBuf(buf);
return(packets[0]);
}
/// <summary>
/// Returns the WintabAxis object for specified device and dimension.
/// </summary>
/// <param name="devIndex_I">Device index (-1 = virtual device)</param>
/// <param name="dim_I">Dimension: AXIS_X, AXIS_Y or AXIS_Z</param>
/// <returns></returns>
public static WintabAxis GetDeviceAxis(Int32 devIndex_I, EAxisDimension dim_I)
{
WintabAxis axis = new WintabAxis();
IntPtr buf = CMemUtils.AllocUnmanagedBuf(axis);
try
{
int size = (int)CWintabFuncs.WTInfoA(
(uint)(EWTICategoryIndex.WTI_DEVICES + devIndex_I),
(uint)dim_I, buf);
// If size == 0, then returns a zeroed struct.
axis = CMemUtils.MarshalUnmanagedBuf <WintabAxis>(buf, size);
}
catch (Exception ex)
{
MessageBox.Show("FAILED GetDeviceAxis: " + ex.ToString());
}
CMemUtils.FreeUnmanagedBuf(buf);
return(axis);
}
/// <summary>
/// Return max normal pressure supported by tablet.
/// </summary>
/// <param name="getNormalPressure_I">TRUE=> normal pressure;
/// FALSE=> tangential pressure (not supported on all tablets)</param>
/// <returns>maximum pressure value or zero on error</returns>
public static Int32 GetMaxPressure(bool getNormalPressure_I = true)
{
WintabAxis pressureAxis = new WintabAxis();
IntPtr buf = CMemUtils.AllocUnmanagedBuf(pressureAxis);
EWTIDevicesIndex devIdx = (getNormalPressure_I ?
EWTIDevicesIndex.DVC_NPRESSURE : EWTIDevicesIndex.DVC_TPRESSURE);
try
{
int size = (int)CWintabFuncs.WTInfo(
(uint)EWTICategoryIndex.WTI_DEVICES,
(uint)devIdx, buf);
pressureAxis = CMemUtils.MarshalUnmanagedBuf <WintabAxis>(buf, size);
}
finally
{
CMemUtils.FreeUnmanagedBuf(buf);
}
return(pressureAxis.axMax);
}
/// <summary>
/// Returns a 3-element array describing the tablet's orientation range and resolution capabilities.
/// </summary>
/// <returns></returns>
public static WintabAxisArray GetDeviceOrientation(out bool tiltSupported_O)
{
WintabAxisArray axisArray = new WintabAxisArray();
tiltSupported_O = false;
IntPtr buf = CMemUtils.AllocUnmanagedBuf(axisArray);
try
{
int size = (int)CWintabFuncs.WTInfo(
(uint)EWTICategoryIndex.WTI_DEVICES,
(uint)EWTIDevicesIndex.DVC_ORIENTATION, buf);
// If size == 0, then returns a zeroed struct.
axisArray = CMemUtils.MarshalUnmanagedBuf <WintabAxisArray>(buf, size);
tiltSupported_O = (axisArray.array[0].axResolution != 0 && axisArray.array[1].axResolution != 0);
}
finally
{
CMemUtils.FreeUnmanagedBuf(buf);
}
return(axisArray);
}