|IMG Developer's Kit: Developer's Kit Guide and Technical Documentation; Version 1.79; User's Guide|
|Prev||Chapter 8. Developer Tools and Examples||Next|
TYPE: External Capabilities for My-T-Soft via DLL
LANGUAGE: C / Windows API
IDE: Microsoft Visual C++ 6
The PaintDLL.DLL with source code outlines what is necessary to integrate external painting to customize and control more of the visual display of My-T-Soft.
The ExternalPaint settings allow you to control the key painting in several ways:
Paint the key background (PaintKeyBackground)
Modify the default key background (PaintKeyModBackground)
Paint the key labels (PaintKeyLabel)
Paint the entire background of the panel (PaintFrame)
Completely Paint the key, bypassing internal painting (PaintKey)
By using internal key values & keyboard info, you can also do small scale modifications, or large scale modifications to the visual display of My-T-Soft!
IMPORTANT NOTE: The ConfigPath determines the location of the INI where you need to modify and add the PaintDLL example below. Refer to the My-T-Soft Setup | File | Show Config File Location for the location, or use My-T-Soft Setup | Configuration | Special Options | Edit My-T-Soft Initialization file.
Here are the relevant settings from the MYTSOFT.INI to achieve examples seen on website:
In [Configuration], the transparency is on, e.g.
The default PaintDLL.DLL is built from the Developer's Kit sample, and this is the MYTSOFT.INI settings:
The key down & up bitmaps were modified to be gray-scale and copied into the Release folder for PaintDLL
If you refer to the Sounds / Advanced notes in the My-T-Soft Manual, you can find a key # reference that can be used within the PaintDLL code to handle specific keys.
This is the sequence the keyboard panels are painted.
The frame (entire panel) is painted (PaintFrame can be used to paint your own frame) Each key is painted in sequence based on its key number
For each key, this is the sequence:
The key background is painted (PaintKeyBackground can be used to paint your own background, or PaintKeyModBackground can be used to modify the default (internal) painted background) The key label (or image) is painted (PaintKeyLabel can be used to paint your own label).
Finally, PaintKey can be used to completely replace or modify a fully painted key
This documents the settings used with the external PaintDLL.DLL
All settings must be in a section headed by [PaintDLL]
The DLLName entry must contain the full path and name of the DLL to be used as the external interface. %PRODDIR% expands to the current location of MYTSOFT.EXE, and
%WINDIR% uses GetWindowsDirectory
see below for general usage - PaintFrame paints the background of the entire panel - see
source for panel reference
see below for general usage - PaintKey can be used to modify the normal painted key (i.e. adding items or modifying the normal key as it is painted) This is called after the entire key has been painted, e.g. the background and the lable has been painted.
see below for general usage - PaintKeyBackground can be used to paint the background of the key, leaving the key label to be painted by My-T-Soft
see below for general usage - PaintKeyModBackground can be used to take the default key background painted by My-T-Soft and modify it prior to painting the label.
see below for general usage - PaintKeyLabel can be used to paint the text in a different style, or use other labels
The settings are listed as a pair - an entry that is used internally by My-T-Soft to determine if the function should be used - if 1, the named function is used, and if 0, the function is not used. If the function is to be used, the Func label entry lists text that is used internally using the GetProcAddress to find the appropriate function in the PAINTDLL.DLL
Refer to the PAINTDLL.C for some examples that paint a custom look keyboard and further notes.
Developers Kit Version 1.78 Release 3 - 9/22/2007
Copyright © 2007 by Innovation Management Group, Inc.
All Rights Reserved.