Menú Configuració - Configurant l'Easy Code

Cada assemblador ha de tenir el seu corresponent fitxer ".cfg" (Fasm.cfg, Fasm64.cfg, GoAsm.cfg, GoAsm64.cfg, etc.) a la carpeta EasyCode\Config, però quan es descarrega l'Easy Code 2 no hi ha cap fitxer ".cfg". En el seu lloc, hi ha un fitxer amb extensió "ori" (ori-ginal) per a cada assemblador, que serveix de guia per tal de tenir una idea del que s'ha de configurar. Aquests fitxers contenen, entre d'altres, les rutes i opcions de la línia d'ordres per a cada assemblador, enllaçador, compilador de recursos i llibreries, i per a cada tipus de projecte. Una vegada més, totes les rutes fan referència a l'arrel del disc C:\ per simplicitat, però com ja s'ha dit abans pot ser qualsevol altre disc o ruta. Només heu de tenir en compte les rutes on teniu les eines corresponents i especificar la ruta correcta per a cada eina a Rutes i opcions de la línia d'ordres, com es veurà més endavant en aquesta secció. Una vegada més, NO es recomana fer servir el disc del sistema C:, especialment amb el Windows 8.1, el Windows 10 i el Windows 11, a causa de la restricció de permisos.

Cada vegada que s'executa, l'Easy Code comprova si cada fitxer "ori" té el seu fitxer equivalent "cfg". Si el fitxer "cfg" ja existeix, no fa res, altrament, fa una còpia del fitxer "ori" però amb l'extensió "cfg". Això fa que els fitxers "ori" mai no siguin modificats i evita que els fitxers ".cfg" siguin creats més d'una vegada (sobreescrits). Si ja heu executat l'Easy Code, podeu veure els fitxers ".cfg" a la carpeta "EasyCode\Config".

L'apartat Configuració està disponible a través del menú Eines-->Configuració i mostra la finestra següent:

Pestanya General

• Mostra la quadrícula als objectes finestra: Indica si s'ha de mostrar una quadrícula damunt dels objectes finestra
• Alinia els controls a la quadrícula: Indica si els controls han d'estar aliniats a la quadrícula
• Mostra la finestra per generar un nou projecte en engegar l'aplicació: Indica si ha d'aparèixer la finestra de crear projectes nous quan l'Easy Code s'inicia sense cap projecte a la seva línia d'ordres
• Mostra la finestra de sortida només si hi ha errors: Indica si la finestra de sortida només ha d'aparèixer quan es produeix algun error en temps de compilació o enllaç
• Desa el projecte automàticament cada (minuts): Indica el període de temps (en minuts) en que el projecte es desarà automàticament. Un valor 0 (predeterminat) significa que aquesta opció està deshabilitada
• Prioritat de l'aplicació: Estableix la prioritat de l'aplicació a Normal (predeterminada), Alta o Baixa
• Configuració predeterminada per als projectes nous: Indica la configuració predeterminada que apareix seleccionada quan es crea un projecte nou
• So per una operació correcta: Indica quin so (o cap) es reproduïrà en una operació correcta
• So per una operació fallida: Indica quin so (o cap) es reproduïrà en una operació fallida
• Idioma: Estableix l'idioma de l'aplicació
• Restaura els valors predeterminats: Restaura totes les opcions anteriors als seus valors predeterminats

Pestanya Editor

Disposa de diverses opcions que us permeten personalitzar l'editor i els panells de l'Easy Code (Explorador del Projecte, Finestra de Propietats i Finestra de Sortida).

Colors

• Fons de l'editor
• Color del text
• Fons del text seleccionat
• Text seleccionat
• Fons de la barra de selecció
• Text de la barra de selecció
• Fons de la línia del cursor
• Text blocat
• Text entre cometes dobles
• Text entre cometes simples
• Text comentat
• Números
• Operadors / Separadors
• Macros
• Funcions de l'API
• Constants de l'API
• Estructures de l'API
• Paraules reservades de l'Easy Code
• Marge dret
• Fons dels panells de l'Easy Code
• Text dels panells de l'Easy Code

Font

• Canvia el nom, tipus i mesura de la font

Tabulació automàtica

• Tabula degudament la propera línia quan es prem la tecla <Enter>

Autocompleta Procs, Macros i Estructures

• Autocompleta tot el bloc dels procediments, les macros i les estructures

Ajuda contextual de variables i constants

• Quan el cursor del ratolí és damunt d'una variable o una constant, mostra una finestra indicant el seu tipus o valor

Ajuda contextual de funcions i macros

• Quan s'escriu una coma després d'un nom de funció (o procediment), mostra el seu prototip complet. També mostra els arguments requerits per a les macros

Ajuda contextual d'estructures (no implementada encara)

• Quan s'escriu un punt després d'un nom d'estructura, mostra una finestra amb tots els seus membres. Aquesta característica encara no està implementada

Acoloreix constants i estructures de l'API

• Habilita l'acoloriment de les constants i estructures de l'API (pot ser lent en ordinadors antics)

Converteix els tabuladors en espais

• Converteix els tabuladors en espais. El número d'espais s'indica a l'opció Amplada de tabulació

Amaga el text seleccionat

• Amaga el text seleccionat quan l'editor no té el focus

Mostra els buttons de col·lapsar

• Mostra o amaga els butons de col·lapsar/expandir

Mostra els números de línia

• Mostra o amaga els números de línia a la barra de selecció

Mostra la barra de selecció

• Mostra o amaga la barra de selecció

Mostra una línia després d'EndP / EndM / EndS

• Dibuixa una línia després d'EndP / EndF / EndM / EndS

Mostra línies verticals a les tabulacions

• Dibuixa una línia vertical a cada tabulació

Amplada de tabulació (en espais):

• Indica el número d'espais per un caràcter (<Tab>)

Marge dret:

• Indica si es dibuixarà el marge dret, el seu estil (sòlid o discontinu) i la columna on s'ha de dibuixar.

OBSERVACIONS: En ordinadors antics pot ser que l'editor funcioni molt lentament. Si és així, proveu de desmarcar l'opció Acoloreix constants i estructures de l'API.

Pestanya Sintaxi

Aquí podeu triar si (i com) la sintaxi de les diferents paraules clau serà convertida.

Compilador

L'opció Conversió predeterminada (recomanada) vol dir que les paraules clau del compilador seran convertides a la mateixa sintaxi que tenen al seu fitxer de configuració corresponent.

Funcions, constants i estructures de l'API

L'opció Converteix a la sintaxi de l'API (recomanada) converteix tots els noms de l'API a la seva sintaxi correcta.

Converteix els noms dels procediments, macros, estructures i variables

Marcant aquesta opció (recomanat) tots aquests noms es convertiran a la seva sintaxi correcta.

Habilita la sintaxi de color

Indica si les paraules clau seran acolorides.

Corregeix la sintaxi

Indica si l'Easy Code afegirà o treurà espais en blanc, segons convingui, per tal d'embellir la sintaxi del codi.

Pestanya Configuracions

La pestanya Configuracions és la part més important de tota la configuració, atès que és on es configuren els assembladors per tal que funcionin correctament i sense errors.

El desplegable Configuració selecciona el fitxer de configuració que es vol inspeccionar o modificar. Un cop s'ha seleccionat una configuració, podeu triar la codificació del text al desplegable Codificació del text. El valor predeterminat és text ANSI (recomanat) i no afecta per res a l'editor del codi, que sempre treballa en mode Unicode, però podeu triar qualsevol altre codificació si ho preferiu, SEMPRE QUE el compilador corresponent la suporti. Altrament, es generaran errors quan es compili el codi font i no es podrà generar el projecte.

D'altra banda, hi ha deu grups de diferents colors on podeu afegir o treure paraules clau (les paraules clau que venen per defecte són les que suporta el compilador que s'està configurant), tenint en compte que cada paraula clau s'acolorirà amb el color del grup en el que està inclosa. Naturalment, podeu canviar el color de cada grup al vostre gust.

IMPORTANT: Quan s'hagin d'afegir noves paraules clau a un o més fitxers de configuració (.cfg), l'Easy Code inclourà aquestes noves paraules clau als fitxers .ori corresponents. Els fitxers .ori es distribueixen amb l'Easy i han d'estar SEMPRE a la subcarpeta Config. Si hi ha noves paraules clau per al Grup seleccionat de la Configuració seleccionada, el botó Actualitza s'activarà per tal que pugueu actualitzar el corresponent fitxer de Configuració (.cfg), altrament el botó Actualitza estarà desactivat. Quan feu clic al botó Actualitza les noves paraules clau s'afegiran al Grup corresponent i es mostraran al final de la list box de les paraules clau, la qual cosa activarà els botons D'acord i Aplica. Finalment, prement qualsevol d'aquest dos botons, les noves paraules clau s'afegiran al Grup corresponent del fitxer de Configuració corresponent (.cfg) sense modificar-hi res més.

Ara, cal que indiqueu les rutes correctes de l'assemblador que esteu configurant. Si hi ha algun projecte carregat si us plau tanqueu-lo, llavors feu clic al botó Rutes i opcions de la línia d'ordres i es mostrarà la finestra següent:

És molt recomanable no tenir cap projecte obert mentre es configuren les rutes i opcions de la línia d'ordres que es mostren en aquesta finestra per a qualsevol dels assembladors que estigueu configurant.

Com podeu veure, totes les rutes incorrectes es pinten de color vermell (a la finestra del damunt les rutes es pinten de color vermell perquè jo tinc totes aquestes eines al disc G:). Ara, si us plau indiqueu les rutes correctes dels fitxers que es necessiten, i recordeu que totes aquelles rutes inexistents (errònies) es pintaran de color vermell. És important que tingueu les eines que s'indiquen per a cada assemblador, només cal que especifiqueu la ruta on les hàgiu instal·lat i, si és possible, que no sigui al disc de sistema C:.

NOTA: Especificar les rutes correctes és imprescindible per tal de poder generar els projectes fàcilment i sense errors.

Les rutes imprescindibles (no opcionals) que s'han d'especificar per tal de generar tots els tipus de projectes, són les que estan etiquetadas com a:

• Compilador


• Enllaçador


• Enllaçador per a drivers (només és necessari a les configuracions JWasm i JWasm64, hauria d'apuntar a la ruta del "link.exe" de Microsoft. No importa si está indicat o no per a les altres configuracions


• Compilador de recursos


• Compilador de llibreries (només és necessari per generar projectes ".lib". El Fasm i el GoAsm no poden generar fitxers llibreria, per tant, les configuracions Fasm, Fasm64, GoAsm i GoAsm64 no necessiten aquesta ruta

Podeu consultar, si ho desitgeu, les opcions de la línia d'ordres per al compilador, l'enllaçador i els compiladors de recursos i llibreries, tant en mode Debug com Release, pero es recomana que NO MODIFIQUEU cap opció de la línia d'ordres en aquest moment. Si us plau deseu aquesta configuració prement el botó D'acord.

Ara podeu repetir les mateixes passes per a totes les altres configuracions, però seria aconsellable que intentessiu generar els projectes d'exemple de l'assemblador que acabeu de configurar (recomanat).

Pestanya Eines

Aquí podeu indicar la ubicació de:

• Un editor d'imatges per tal d'editar bitmaps, icones o cursors
• L'ajuda del Win32, que s'iniciarà quan es premi Ctrl+W
• Un programa depurador (debugger). Aquest depurador pot ser diferent per a cada configuració, per tant, no es pot indicar si no hi ha un projecte carregat. El depurador s'iniciarà quan es premi la tecla F5 (només per a projectes de fitxer executable)
• Un programa calculadora (per defecte, el calc.exe del Windows)
• Un programa editor de text (per defecte, el notepad.exe del Windows)

Pestanya Ajuda - Configurant altres fitxers d'ajuda

A la pestanya Ajuda hi podeu configurar fins a sis altres fitxers d'ajuda (per Opcodes, FPU, MMX, etc.). Fent un doble clic en una etiqueta (Help #1, Help #2, etc.) podreu canviar el seu text adequant-lo al fitxer relacionat que s'ha d'obrir. El text de cada etiqueta serà el que es mostrarà a l'ítem corresponent del menú Ajuda.

OBSERVACIONS: Cadascuna de les entrades pot indicar la ruta d'un fitxer d'ajuda o una adreça web (URL). En tots dos casos, fitxer o URL, el text es pintarà de color vermell si és incorrecte. Per tal de determinar si el text s'ajusta o no al format vàlid d'URL, es crida la funció de l'API PathIsURL.