Heaventools

   English English  Deutsch Deutsch

Erste Schritte mit Resource Tuner Console

Resource Tuner Console Resource Tuner Console ist ein leistungsstarkes Befehlszeilentool, das für Ressourcenbearbeitungsaufgaben entwickelt wurde. Als skriptfähiges Programm kann es nahtlos von der Konsole aus ausgeführt werden, was es ideal für die Verwendung in Stapeldateien (.bat) macht. Für Benutzer, die einen visuellen Ressourcen-Editor mit einer grafischen Benutzeroberfläche (GUI) suchen, ist Resource Tuner GUI perfekt geeignet.

Resource Tuner Console (RTC) akzeptiert Eingaben aus einer Skriptdatei. RTC-Skripte sind einfache Textdateien und haben die Erweiterung .RTS (was für Resource Tuner Script steht). Diese Skriptdateien können bequem mit jedem ASCII-Texteditor bearbeitet werden.

RTC liest und führt Skripte mithilfe des Windows Script Host-Engine aus. Da der Windows Script Host Teil der Standard-Betriebssysteminstallation ist, können Sie RTC problemlos auf jedem Windows-Rechner ausführen.

RTC verwendet VBScript als Standardskriptsprache. Jede aktive Skriptsprache, die vom Windows Script Host installiert und unterstützt wird, kann jedoch zur Erstellung von Skripten für RTC verwendet werden.


So funktioniert es

Die Verwendung von Resource Tuner Console umfasst in der Regel die folgenden Schritte:

1Erstellung des Skripts: Benutzer verfassen entweder Skripte, die Bearbeitungsvorgänge für Ressourcen enthalten und den Anforderungen der Skriptsprache folgen, oder verwenden vorkonfigurierte und einsatzbereite Beispiele. Für weitere Details lesen Sie den Leitfaden zur Verwendung von RTC-Skripten.

2Spezifizierung von Dateipfaden: Benutzer geben in dem Skript die Dateinamen und Pfade für die Quell- und Zielspeicherorte an.

3Ausführung über Batch-Datei: RTC wird von einer Batch-Datei aus gestartet. Resource Tuner Console verarbeitet das Skript, bearbeitet effektiv die Ressourcen der angegebenen Datei gemäß den definierten Vorgängen und speichert die modifizierte Datei im Zielort.


Verwendung

Wenn Resource Tuner Console ohne Parameter verwendet wird, stellt es allgemeine Hilfe zur Verwendung der Befehlszeilenschnittstelle bereit.

Um die allgemeine Hilfe über die Befehlszeile aufzurufen, geben Sie einfach rtc.exe ein. Dadurch werden Informationen und Anweisungen zur Verwendung der Befehlszeilenschnittstelle von RTC angezeigt.

Resource Tuner Console


Programm von der Befehlszeile aufrufen

Um Resource Tuner Console von der Befehlszeile aus zu starten, geben Sie den folgenden Befehl ein: rtc.exe /F:ScriptFile (bei Bedarf den vollständigen Pfad einschließen).

Beispiel:   rtc.exe /F:"c:\temp\my_script.rts"


Ausführung aus einer Batch-Datei

Um Resource Tuner Console aus einer Batch-Datei heraus auszuführen, erstellen Sie eine neue Datei mit der Erweiterung .bat und fügen Sie den Befehl rtc.exe /F:"PathToScriptName" hinzu.

Das Ausführen der Batch-Datei erfolgt einfach durch Klicken darauf. Alternativ können Sie Batchdateien über die Befehlszeile oder die Start/Ausführen-Zeile ausführen. Wenn Sie sie von diesen Standorten aus ausführen, stellen Sie sicher, den vollständigen Dateinamen zu verwenden, es sei denn, der Dateipfad ist in der Umgebungsvariable "Path" enthalten.

Beispiele für Batch-Dateien:

Beispiel 1

rtc /L:"log.txt" /F:"edit_manifest.rts"
 

Beispiel 2

@CLS
@SET CURRENT_DIR="%CD%"
@SET BATH_DIR="%~dp0"
@CD %BATH_DIR% || EXIT 100
@CD .. || EXIT 100
@CD .. || EXIT 100
@SET PATH=%PATH%;%CD%
@CD %BATH_DIR% || EXIT 100

rtc /L:"%~dp0\log.txt" /F:"edit_icons.rts"

@CD %CURRENT_DIR% || EXIT 100
 

Resource Tuner Console enthält verschiedene Beispiele, die seine grundlegende Funktionalität zeigen und die zahlreichen verfügbaren Funktionen hervorheben. Nach der Installation von Resource Tuner Console können Sie diese Beispiele im Ordner "Demo Scripts" im Installationsverzeichnis finden. Schauen Sie dort nach weiteren Beispielen für Batch-Dateien.

Beispiel-Skripte Schritt-für-Schritt-Anleitung zur Verwendung von RTC-Skripten


Syntax

RTC [Optionen] /F:SkriptName

Optionen:

 /S

Lautlosmodus aktivieren.

 /L[:LogName]

Protokollierung aktivieren.

 /A

Protokoll anfügen.

 /plhdXX="Wert"

Wert an das Skript mit einem Platzhalter übergeben.

 /E

Benutzersprache überschreiben.


Parameter

/F:SkriptName
Skriptdateiname. Erforderlich. Gibt den Namen einer Skriptdatei an. Standardmäßig erwartet das Programm, die Skriptdatei im selben Verzeichnis wie das Programm zu finden, falls dieser Parameter keinen vollqualifizierten Pfadnamen enthält. Wenn ein Dateiname und/oder ein Pfadname Leerzeichen enthalten, müssen sie in doppelte Anführungszeichen eingeschlossen werden.


Optionen

/S
Lautlosmodus aktivieren (Silent mode on). Optional. Weist das Programm an, still zu sein. Es werden keine Ereignisse auf dem Bildschirm angezeigt.

/L[:LogName]
Protokollierung aktivieren (Logging mode on). Optional. Gibt den Namen einer Protokolldatei an (einschließlich des vollständigen Pfads, falls vorhanden) und veranlasst das Programm, eine Protokolldatei zu erstellen, in der alle Ereignisse und Aktionen während des Bearbeitungsprozesses detailliert aufgeführt sind. Wenn Sie vermuten, dass ein Skript nicht die gewünschten Ergebnisse liefert, gibt Ihnen die Protokolldatei jedes kleine Detail an. Vergessen Sie nicht, Anführungszeichen zu verwenden, wenn der Protokollname Leerzeichen enthält. Wenn das Argument LogName weggelassen wird, verwendet das Programm den Standardnamen RTC.log und erstellt eine Protokolldatei im selben Verzeichnis wie das Programm. Wenn der Parameter /L weggelassen wird, gibt das Programm keine Ausgabe in die Datei aus.

/A
Protokoll anfügen (Append log). Optional. Weist das Programm an, ein Protokoll an die vorhandene Protokolldatei anzufügen. Wenn der Parameter /A weggelassen wird, überschreibt das Programm die vorhandene Protokolldatei.

/plhdXX="Wert"
Wert an das Skript mit einem Platzhalter übergeben. Optional. Weist das Programm an, in Ihrem Skript nach einem angegebenen Platzhalter plhdXX zu suchen und ihn durch den Wert zu ersetzen, wobei:

'plhd': Dieses reservierte Wort gibt einen Platzhalter an und ist erforderlich.
'XX': Eine beliebige ID. Sie können einen beliebigen Bezeichner nach dem reservierten Wort "plhd" verwenden, um den Platzhalter eindeutig zu identifizieren, z. B. /PLHD01 oder /plhd_MyData
"Wert": Dies ist der Wert, den Sie in das Skript einfügen möchten. Anführungszeichen sind erforderlich!

/E
User Language Override. Optional. Weist das Programm an, für seine Ausgabe immer Englisch zu verwenden. Wenn der Parameter /E weggelassen wird, gibt RTC die Nachrichten je nach Gebietsschema des Benutzers in Englisch, Niederländisch, Deutsch, Finnisch, Französisch, Spanisch, Schwedisch, Japanisch, Italienisch, Koreanisch, Portugiesisch, Russisch oder Polnisch aus.


Beispiele


   Beispiel 1

Der folgende Befehl führt das Skript aus und erstellt standardmäßig eine Protokolldatei mit dem Namen rtc.log im gleichen Verzeichnis, in dem sich das Programm befindet:

   RTC /L /F:"C:\RTC Folder\my test script.rts"

Wie im obigen Beispiel gezeigt, müssen Dateinamen, die Leerzeichen enthalten, in Anführungszeichen eingeschlossen werden.

Als Reaktion darauf zeigt Resource Tuner Console detailliert alle Ereignisse und Aktionen während des Bearbeitungsprozesses an. Etwaige Syntaxfehler und/oder Fehler, die während der Kompilierung auftreten, werden gemeldet, damit Sie sie korrigieren können.


   Beispiel 2

Der folgende Befehl führt das Skript leise aus und erstellt oder fügt ein Protokoll zur vorhandenen Protokolldatei mit dem Namen my logfile.log im vom Benutzer definierten Verzeichnis hinzu:

   RTC /S /L:"D:\logs\my logfile.log" /A /F:"my_script.rts"

Wie im obigen Beispiel gezeigt, müssen Dateinamen, die Leerzeichen enthalten, in Anführungszeichen eingeschlossen werden.

Resource Tuner Console zeigt daraufhin keine Ereignisse auf dem Konsolen-bildschirm an.



Verwendungshinweise für Platzhalter

Platzhalter in RTC-Skripten bieten eine praktische Möglichkeit, Werte aus einer Stapeldatei in ein Skript zu übergeben.

Diese Funktion ist besonders nützlich, wenn Sie spezifische Werte für ein Skript ändern oder dasselbe Skript mit verschiedenen Werten ausführen müssen, ohne separate Skriptdateien zu erstellen. Durch die Verwendung von Platzhaltern können Sie die Flexibilität und Wiederverwendbarkeit Ihrer RTC-Skripte verbessern und so Ihre Skripte an verschiedene Anwendungsfälle anpassen.

Sie können mehrere Platzhalter in Ihren Skripten verwenden und somit ein einziges generisches Skript erstellen, das mit unterschiedlichen Parametern aufgerufen werden kann.

Beispiel:

rtc /plhd_bool="True" /plhd_str="Hello!" /plhd01="10" /F:"script.rts"

Innerhalb des Skriptkörpers muss jeder Platzhalter von Prozentzeichen (%) umschlossen sein. Während der Skriptausführung werden die folgenden Platzhalter im Skript:


MainFlag = %plhd_bool%
HelloStr = "%plhd_str%"
Counter = %plhd01%

durch die entsprechenden Werte ersetzt:


MainFlag = True
HelloStr = "Hello!"
Counter = 10



Exit-Codes

Resource Tuner Console gibt unterschiedliche Exit-Codes zurück, um den Status der Skriptausführung zu kommunizieren. Hier sind die entsprechenden Exit-Codes und ihre Bedeutungen:

  • Exit-Code 0: Das Skript wurde erfolgreich abgeschlossen.
  • Exit-Code 1: Ungültige Befehlszeilenparameter wurden angegeben.
  • Exit-Code 2: Die Skriptdatei konnte nicht geöffnet werden.
  • Exit-Code 3: Das Skript hat während der Ausführung einen Fehler oder Syntaxfehler festgestellt.
  • Exit-Code 4: Der Skriptdateiname wurde nicht angegeben.
  • Exit-Code 5: Die angegebene Skriptdatei wurde nicht gefunden.
Beispiel für Beendigungscodes:
	
@echo off  
start /wait rtc.exe /F:"c:\temp\my_script.rts"

 if errorlevel 0 goto 0
 if errorlevel 1 goto 1
 if errorlevel 2 goto 2
 if errorlevel 3 goto 3
 if errorlevel 4 goto 4
 if errorlevel 5 goto 5
 goto done

 :0
 echo Script completed OK 
 goto done  

 :1 
 echo ERROR: Invalid parameters   
 goto done   
 
 :2   
 echo ERROR: Script file could not be opened
 goto done   
  
 :3
 echo ERROR: Script failed

 :4   
 echo ERROR: Script file name not specified
 goto done   
  
 :5
 echo ERROR: Script file not found
    
 :done

 

Probieren Sie es in Ihrem Workflow aus: Beginnen Sie mit der kostenlosen Testversion

Laden Sie Resource Tuner Console herunter, um sie für Ihr Projekt zu evaluieren.

Laden Sie Resource Tuner Console herunter Resource Tuner Console läuft auf allen heute verwendeten Versionen von Windows, von 11 bis XP, sowohl 32-Bit als auch 64-Bit.

 

Haben Sie eine Frage?

Bitte schauen Sie sich unbedingt unseren FAQ-Bereich für Antworten auf die am häufigsten gestellten Fragen an.

Wir würden uns freuen, von Ihnen zu hören! Wenn Sie Fragen, Feedback, Fehlerberichte, Feature-Anfragen oder Vorschläge zu Resource Tuner Console haben, zögern Sie bitte nicht, uns zu kontaktieren. Ihre Rückmeldungen sind von unschätzbarem Wert, da sie uns dabei helfen, Funktionen und Verbesserungen basierend auf den Benutzerbedürfnissen zu priorisieren.