Hot Door CORE 0.8.2
Adobe® Illustrator® Plug-in Library
Loading...
Searching...
No Matches
Classes | Enumerations | Functions
hdicoreRuntime.h File Reference

Header file for general runtime-related functions. More...

#include "hdicoreSize.h"
Include dependency graph for hdicoreRuntime.h:

Classes

class  hdi::core::ClipboardData
 Used to contain data when writing/reading to/from the clipboard. More...
 

Enumerations

enum  hdi::core::LibVersion {
  LibVersion_Unknown = 0 , LibVersion_0_5_0 = 500 , LibVersion_0_5_1 = 501 , LibVersion_0_5_2 = 502 ,
  LibVersion_0_5_3 = 503 , LibVersion_0_5_4 = 504 , LibVersion_0_5_5 = 505 , LibVersion_0_5_6 = 506 ,
  LibVersion_0_5_7 = 507 , LibVersion_0_5_8 = 508 , LibVersion_0_5_9 = 509 , LibVersion_0_6_0 = 600 ,
  LibVersion_0_6_1 = 601 , LibVersion_0_6_2 = 602 , LibVersion_0_6_3 = 603 , LibVersion_0_7_0 = 700 ,
  LibVersion_0_7_1 = 701 , LibVersion_0_7_2 = 702 , LibVersion_0_7_3 = 703 , LibVersion_0_7_4 = 704 ,
  LibVersion_0_7_5 = 705 , LibVersion_0_7_6 = 706 , LibVersion_0_7_7 = 707 , LibVersion_0_7_8 = 708 ,
  LibVersion_0_8_0 = 800 , LibVersion_0_8_1 = 801 , LibVersion_0_8_2 = 802
}
 Indicates a specific version of the hdi_core library.
 
enum  hdi::core::SystemVersion { UnknownSystemVersion = 0 }
 Describes the OS version that the plug-in is running within.
 
enum  hdi::core::KeyboardLanguage {
  UnknownKeyLang = 0 , AfghanPashtoKeyLang = 10 , ArabicKeyLang = 20 , ArmenianKeyLang = 30 ,
  AzeriKeyLang = 40 , BanglaKeyLang = 50 , BelgianKeyLang = 60 , BulgarianKeyLang = 70 ,
  BelarusianKeyLang = 80 , CherokeeKeyLang = 90 , ChineseSimplifiedKeyLang = 100 , ChineseTraditionalKeyLang = 110 ,
  CroatianKeyLang = 120 , CzechKeyLang = 130 , DanishKeyLang = 140 , DevanagariKeyLang = 150 ,
  DutchKeyLang = 160 , EnglishAmericanKeyLang = 170 , EnglishAustralianKeyLang = 180 , EnglishBritishKeyLang = 190 ,
  EnglishCanadianKeyLang = 200 , EnglishOtherKeyLang = 210 , EstonianKeyLang = 220 , FaroeseKeyLang = 230 ,
  FinnishKeyLang = 240 , FrenchKeyLang = 250 , FrenchCanadianKeyLang = 260 , FrenchSwissKeyLang = 270 ,
  GeorgianKeyLang = 280 , GermanKeyLang = 290 , GermanAustrianKeyLang = 300 , GermanSwissKeyLang = 310 ,
  GreekKeyLang = 320 , GujaratiKeyLang = 330 , GurmukhiKeyLang = 340 , HawaiianKeyLang = 350 ,
  HebrewKeyLang = 360 , HungarianKeyLang = 370 , InuktitutKeyLang = 380 , IrishKeyLang = 390 ,
  ItalianKeyLang = 400 , JapaneseKeyLang = 410 , KannadaKeyLang = 420 , KazakhKeyLang = 430 ,
  KhmerKeyLang = 440 , KoreanKeyLang = 450 , KurdishSoraniKeyLang = 460 , LatvianKeyLang = 470 ,
  LithuanianKeyLang = 480 , MacedonianKeyLang = 490 , MalayalamKeyLang = 500 , MalteseKeyLang = 510 ,
  MaoriKeyLang = 520 , NepaliKeyLang = 530 , NorwegianKeyLang = 540 , OriyaKeyLang = 550 ,
  PersianKeyLang = 560 , PersianDariKeyLang = 570 , PolishKeyLang = 580 , PortugueseKeyLang = 590 ,
  PortugueseBrazilianKeyLang = 600 , RomanianKeyLang = 610 , RussianKeyLang = 620 , SamiKeyLang = 630 ,
  SerbianKeyLang = 640 , SinhalaKeyLang = 650 , SlovakKeyLang = 660 , SlovenianKeyLang = 670 ,
  SpanishKeyLang = 680 , SwedishKeyLang = 690 , TamilKeyLang = 700 , TeluguKeyLang = 710 ,
  ThaiKeyLang = 720 , TibetanKeyLang = 730 , TurkishKeyLang = 740 , UkrainianKeyLang = 750 ,
  UrduKeyLang = 760 , UyghurKeyLang = 770 , VietnameseKeyLang = 780 , WelshKeyLang = 790
}
 Describes the language for which the current (keyboard) input source is designed.
 
enum  hdi::core::KeyboardLayout { KeyLayout_Unknown = 0 }
 Describes the layout of the current (keyboard) input source. More...
 

Functions

LibVersion hdi::core::version ()
 Gets the version of the hdi_core library against which the plugin was built.
 
std::string hdi::core::versionString ()
 Gets the version of the hdi_core library as a string.
 
SystemVersion hdi::core::systemVersion ()
 Gets the version of the OS in which the plug-in is being run.
 
std::string hdi::core::machineUUID ()
 Gets the UUID for the machine on which the plug-in is being run.
 
Size hdi::core::screenDimensions ()
 Gets the dimensions of the user's primary screen.
 
bool hdi::core::browserAvailable ()
 Gets whether the OS has a browser available.
 
bool hdi::core::storeClipboardData ()
 Stores the current clipboard data for later restoration.
 
bool hdi::core::restoreClipboardData ()
 Restores the clipboard data (from the stored data from an earlier call to the storeClipboardData() function)
 
bool hdi::core::clipboardData (ClipboardData &data__)
 Gets the data currently on the clipboard.
 
bool hdi::core::setClipboardData (const ClipboardData &data_)
 Sets the data currently on the clipboard.
 
MouseButton hdi::core::mouseButtonsPressed ()
 Gets which mouse buttons are currently pressed (can be called anytime)
 
ModifierKey hdi::core::modifierKeysPressed ()
 Gets which modifier keys are currently pressed (can be called anytime)
 
KeyboardLanguage hdi::core::keyboardLanguage ()
 Gets the best-fit keyboard language for the current input source (keyboard layout)
 
KeyboardLayout hdi::core::keyboardLayout ()
 Gets the current keyboard layout.
 

Detailed Description

Header file for general runtime-related functions.

Enumeration Type Documentation

◆ KeyboardLayout

Describes the layout of the current (keyboard) input source.

Note
Unfortunately, Mac and Windows describe layouts in completely different manners, so there is no good way to "marry" the two of them in cross-platform values

Function Documentation

◆ browserAvailable()

bool hdi::core::browserAvailable ( )

Gets whether the OS has a browser available.

Author
GW
Date
08/2013
Returns
true if a browser is available, false otherwise

◆ clipboardData()

bool hdi::core::clipboardData ( ClipboardData data__)

Gets the data currently on the clipboard.

Author
GW
Date
02/2015
Parameters
data__Return-by-reference for the clipboard data
Returns
true if the data could be acquired, false otherwise

◆ keyboardLanguage()

KeyboardLanguage hdi::core::keyboardLanguage ( )

Gets the best-fit keyboard language for the current input source (keyboard layout)

Author
GW
Date
04/2014
Returns
Best-fit keyboard language for the current layout
Note
Not all values from the Windows portion of the KeyboardLayout enum are processed internally by this function, due to there being no equivalent Mac values. The same goes for the Mac portion being translated to Windows values. For these cases, call the keyboardLayout() function yourself and process the output.

◆ keyboardLayout()

KeyboardLayout hdi::core::keyboardLayout ( )

Gets the current keyboard layout.

Author
GW
Date
04/2014
Returns
The current OS-specific keyboard layout enum value

◆ machineUUID()

std::string hdi::core::machineUUID ( )

Gets the UUID for the machine on which the plug-in is being run.

Author
GW
Date
09/2013
Returns
A UUID string for the user's machine, or "" if it cannot be acquired
Note
This function is not guaranteed to return the same value for all versions of the app. However, within the same version of the app and on the same platform, this function will always return the same value for a given machine (barring the user replacing some component which the OS uses for the UUID calculation, but that is out of our control).

◆ modifierKeysPressed()

ModifierKey hdi::core::modifierKeysPressed ( )

Gets which modifier keys are currently pressed (can be called anytime)

Author
GW
Date
04/2014
Returns
A bitwise OR of ModifierKey enum values for the currently pressed keys

◆ mouseButtonsPressed()

MouseButton hdi::core::mouseButtonsPressed ( )

Gets which mouse buttons are currently pressed (can be called anytime)

Author
GW
Date
07/2014
Returns
A bitwise OR of MouseButton enum values for the currently pressed buttons

◆ restoreClipboardData()

bool hdi::core::restoreClipboardData ( )

Restores the clipboard data (from the stored data from an earlier call to the storeClipboardData() function)

Author
GW
Date
01/2018
Returns
true for success, false otherwise
Warning
This function must be called after the storeClipboardData() function, within the same message context from the parent app!

◆ screenDimensions()

Size hdi::core::screenDimensions ( )

Gets the dimensions of the user's primary screen.

Author
GW
Date
08/2013
Returns
The dimensions of the user's primary display, in pixels

◆ setClipboardData()

bool hdi::core::setClipboardData ( const ClipboardData data_)

Sets the data currently on the clipboard.

Author
GW
Date
02/2015
Parameters
data_New clipboard data
Returns
true if the data could be set, false otherwise

◆ storeClipboardData()

bool hdi::core::storeClipboardData ( )

Stores the current clipboard data for later restoration.

Author
GW
Date
01/2018
Returns
true for success, false otherwise
Warning
The restoreClipboardData() function must be called after this function, within the same message context from the parent app!
Note
This function is useful when needing to temporarily override data in the clipboard; call this function, change whatever you need in the clipboard, then call restoreClipboardData() thereafter.

◆ systemVersion()

SystemVersion hdi::core::systemVersion ( )

Gets the version of the OS in which the plug-in is being run.

Author
GW
Date
05/2014
Returns
Platform-specific enum value for the OS version

◆ version()

LibVersion hdi::core::version ( )

Gets the version of the hdi_core library against which the plugin was built.

Author
GW
Date
12/2013
Returns
Version enum value for the hdi_core lib

◆ versionString()

std::string hdi::core::versionString ( )

Gets the version of the hdi_core library as a string.

Author
GW
Date
12/2013
Returns
A stringified variation of the version() function