BMXtool Kurzbeschreibung 
========================

Version 1.0

Inhalt
======

1. Allgemein
2. Programmaufruf
3. BMXtool Projektdatei
4. Beispiele


1. Allgemein
============

BMXtool ist ein Kommandozeilentool fr die Erstellung von
Grafikdateien im HEIDENHAIN BMX-Format.

Wie das Acronym BMX bereits andeutet, handelt es sich um ein
erweitertes Bitmap Format (BitMap eXtended). 
In diesem Dateiformat knnen neben einem 24-bit Bitmap als 
Grundbild auch Differenzbilder und Texte enthalten sein, die
gezielt ber eine Library von der HEIDENHAIN Steuerung iTNC 530
angesprochen werden knnen.

Damit ist es mglich auf der Steuerung Bilder sprachabhngig 
bzw. abhngig von Systemparametern (z.B. aktiver/nicht aktiver 
Softkey) anzuzeigen, ohne fr jede Variante eine eigene Datei 
vorsehen zu mssen.


2. Programmaufruf
=================

BMXtool <Projektdatei>

Projektdatei     : Die Projektdatei (Dateierweiterung typischerweise .BPJ)
                   enthlt alle zur Generierung notwendigen Informationen
                   als Textdatei mit einem einfachem Format

Alle mglichen Kommandozeilen-Parameter bekommen Sie angezeigt, wenn Sie 
BMXtool ohne Parameter aufrufen.


3. BMXtool Projektdatei
=======================

Die Projektdatei enthlt alle zur Generierung notwendigen Informationen 
als Textdatei. Dabei wird jede Zeile durch ein Schlsselwort eingeleitet, 
dem zustzliche Parameter folgen knnen. 
Die Parameter sind durch Komma, Leerzeichen oder Tabulatorzeichen vom 
Schlsselwort bzw. untereinander abgetrennt. Parameter, die selbst 
Leerzeichen enthalten, knnen durch Einschliessen in einfache oder doppelte
Anfhrungsstriche als zusammengehriger Parameter gekennzeichnet werden.

Kommentarzeilen (eingeleitet durch Semicolon) und Leerzeilen sind zulssig.
Hufig wird eine Einrckung der Schlsselworte vorgenommen, um die
Abhngigkeiten der Schlsselworte besser erkennen zu knnen.


Schlsselworte bersicht:
-------------------------

Schlsselwort   Kommentar                      Parameter  
--------------+------------------------------+-----------------------------
BMX             Leitet die BMX Daten ein       Zieldateiname (.BMX Datei)

ENDBMX          Schliesst den BMX Eintrag ab   -

BMP             Verweis auf Bitmap Datei       Dateiname, Attribut(e) 

TXT             Texteintrag                    Text/Textverweis, Attribut(e)

ENDTXT          Schliesst den TXT Eintrag ab   -

TXTEMPLATE      Vorlagen fr                   Templatekennung
                Position und Gre

ALIGN           horizontale Textausrichtung    Alignkennung

RELPOS          Relative Position              X-Koordinate, Y-Koordinate

RELFONTSIZE     Relative Fontgre             Size-Wert 

VERTALIGN       vertikale Textausrichtung      Alignkennung

ATTR            Eintrags-Attribut              Attributkennung

LANG            Eintrags-Sprache               Sprachkennung 

LANGUAGEPATH    Verzeichnis fr                Verzeichnispfad 
                Includedateien 




BMX            
---
Leitet die BMX Daten ein. Als Parameter geben Sie den Zieldateinamen 
an (.BMX Datei).
Wenn Sie den Systemparameter %RES% in den BMX Dateipfad einfgen
(Beispiel: 'r:\test\bmxtool\end\%RES%\end.bmx'), wird
sowohl fr die Auflsung 1024x768 als auch 640x480 eine eigene 
Datei erzeugt.Dabei wird der "%RES%" String durch "1024x768" bzw.
"640x480" ersetzt. Dieser Ersetzungsmechanismus wirkt dann auch 
analog fr die BMP Eintrge, um die jeweils passenden Bildquellen 
auszuwhlen.


ENDBMX         
------
Schliesst den BMX Eintrag ab


BMP
---
Verweis auf Bitmap Datei. Als Parameter geben Sie den Dateinamen an
Attribut(e) knnen Sie optional angeben
Die erste Bitmap Datei beinhaltet das Grundbild. Von den brigen BMP Eintrgen
wird nur das Differenzbild in der BMX Datei abgelegt.


TXT            
---
Texteintrag. Als Parameter geben Sie direkt den Text ein oder einen 
Textverweis auf einen Eintrag in einer Includedatei.
Attribut(e) knnen Sie optional eingeben.


ENDTXT
------
Schliesst den TXT Eintrag ab


TXTEMPLATE     
----------
Fr Softkey verwendete Vorlagen, die Position und Gre
von Texten festlegen.

Folgende TXTEMPLATE-Kennungen werden z.Zt. von der iTNC
untersttzt:

"TXT30C9" Text in 1. von 3 Zeilen, zentriert
"TXT31C9" Text in 2. von 3 Zeilen, zentriert
"TXT32C9" Text in 3. von 3 Zeilen, zentriert

"TXT30L9" Text in 1. von 3 Zeilen, linksbndig
"TXT31L9" Text in 2. von 3 Zeilen, linksbndig
"TXT32L9" Text in 3. von 3 Zeilen, linksbndig

"TXT30R9" Text in 1. von 3 Zeilen, rechtsbndig
"TXT31R9" Text in 2. von 3 Zeilen, rechtsbndig
"TXT32R9" Text in 3. von 3 Zeilen, rechtsbndig
"TXTCYNR" Text Zyklusnummer von Zyklus Softkey

"TXTMC5", Text mittlere Schriftgre zentriert
"TXTBC5", Text groe Schriftgre zentriert

"TXT20C9" Text in 1. von 2 Zeilen, zentriert
"TXT21C9" Text in 2. von 2 Zeilen, zentriert

"TXT20L9" Text in 1. von 2 Zeilen, linksbndig
"TXT21L9" Text in 2. von 2 Zeilen, linksbndig

"TXT20R9" Text in 1. von 2 Zeilen, rechtsbndig
"TXT21R9" Text in 2. von 2 Zeilen, rechtsbndig

Hinweis:
- die letzte Ziffer zeigt die maximal mgliche Zeichenzahl an


ALIGN
-----
Horizontale Textausrichtung

LEFT: linksbndig
CENTER: mittig
RIGHT: rechtsbndig


RELPOS
------
Relative Position bezogen auf Bildmitte 
Als Parameter geben Sie die
X-Koordinate und die Y-Koordinate ein.
Der Bereich geht von -10000 bis +10000. 
Dabei entspricht 20000 der gesamten 
Bildschirmbreite bzw. Hhe. 
Somit ist diese Angabe auflsungsunabhngig.

RELFONTSIZE    
-----------
Relative Fontgre (Skalierung siehe RELPOS)


VERTALIGN      
---------
vertikale Textausrichtung      
Alignkennung
TOP: Textoberkante
BASELINE: Textunterkante
BOTTOM: Textunterkante einschliesslich Unterlngen (z.B. bei g)


LANGUAGEPATH   
------------
Verzeichnis, in dem sich Includedateien befinden, die 
sprachabhngige Texte enthalten.

Die Namen der Includedateien folgen der Konvention
<language id>.inc
Fr <language id> ist die zweibuchstabige Dialogsprachenkennung
(siehe auch unter LANG; z.B. de fr deutsch) zu verwenden

Es wird dann fr jede gefundene Sprachdatei eine Textvariante
fr den Text erzeugt, der einen Textverweis (@<database id>)
in die Includedatei enthlt.


ATTR
----
Die Kennung "ATTR" wird bei Softkeys und Hilfsbildern eingesetzt
Sie kennzeichnen damit ein Bildelement, das nur bei entsprechend
gesetztem Steuerungs-Systemparameter (z.B. aktiver/nicht aktiver Softkey) 
angezeigt wird.

Softkeys:

01: Softkey normal
02: Softkey aktiv  (z.B. fr CHECK-Softkeys)

Hilfsbilder:

01: 1. Zyklusparameter aktiv
02: 2. Zyklusparameter aktiv
03: 3. Zyklusparameter aktiv
...
usw.

Hinweis:
- Dieser Eintrag kann im BMP und TXT Eintrag auch direkt als 
  Parameter gesetzt werden. 
  Format:
    ATTR:<Attr Wert> 
  ( z.B. ATTR:01 )


LANG
----
Die Kennung "LANG" wird fr sprachabhngige Grafiken oder Texte 
eingesetzt.
Sie kennzeichnen damit ein Bildelement, das nur dann angezeigt wird,
wenn die angegebene Sprache auf der Steuerung aktiv ist.
Als Werte werden die 2-buchstabigen DIN Kennungen fr 
Dialog-Sprachen eingesetzt.

cs Tschechisch
da Dnisch
de Deutsch
en Englisch
es Spanisch
fi Finnisch
fr Franzsisch
it Italienisch
nl Niederlndisch
pt Portugiesisch
sv Schwedisch

Hinweis:
- Dieser Eintrag kann im TXT Eintrag auch direkt als 
  Parameter gesetzt werden. 
  Format:
    LANG:<language id> 
  ( z.B. LANG:de )




4. Beispiele
============

Beispiel eines attribut- und sprachabhngigen Softkeys

==========================================================
BMX  'r:\test\plcsoftkey\%RES%\coolant.bmx'     skCoolant
  BMP r:\test\plcsoftkey\%RES%\cool_off.bmp, ATTR:01,
  BMP r:\test\plcsoftkey\%RES%\cool_on.bmp, ATTR:02

  TXT 'Coolant'
    TXTEMPLATE  TXT31C9
  ENDTXT  
  TXT 'OFF' ATTR:01 LANG:en
    TXTEMPLATE  TXT32C9
  ENDTXT  
  TXT 'ON' ATTR:02 LANG:en
    TXTEMPLATE  TXT32C9
  ENDTXT  
  TXT 'AUS' ATTR:01 LANG:de
    TXTEMPLATE  TXT32C9
  ENDTXT  
  TXT 'EIN' ATTR:02 LANG:de
    TXTEMPLATE  TXT32C9
  ENDTXT  
BMXEND
==========================================================



Beispiel fr eine BMXtool Projektdatei mit sprachabhngigen 
Texteintrgen aus Includedateien:


==========================================================
;PLC SOFTKEY Project File - Version 1.0
; Generated by povfilt.pl


; Verzeichnis, das de.inc, en.inc, fr.inc und it.inc enthlt:
LANGUAGEPATH 'Q:\PovScripts\data\language'


BMX 'r:\test\bmxtool\end\%RES%\end.bmx'
  BMP 'r:\test\bmxtool\end\%RES%\en_01.bmp', ATTR:01
  BMP 'r:\test\bmxtool\end\%RES%\xx_02.bmp', ATTR:02
  TXT '@SNR_END'
    TXTEMPLATE TXT30L9
  ENDTXT
ENDBMX
==========================================================



Beispiel fr detaillierte Textauszeichnungen:

==========================================================
LANGUAGEPATH 'Q:\PovScripts\data\language'

BMX
  TXT '@SNR_SK_TEXT1' 
    ATTR 01        
    RELFONTSIZE 6250
    RELPOS      -18000, 6000
    ALIGN       LEFT
    VERTALIGN   BOTTOM
  ENDTXT
  TXT 'cd'
      RELFONTSIZE 6250
      RELPOS      8000, 3000
      ALIGN       LEFT
      VERTALIGN   BASELINE
  ENDTXT
ENDBMX
==========================================================
