Potrebno je razširiti datoteko phigs.js tako, da se doda nov način izhoda v okno, ki bo vsebovalo DXF code za vnos v CAD modelirnike. S tem bo hkrati poleg prikaza v brskalniku v vseh programih možen izpis v DXF obliki brez bistvenih popravkov kode osnovnega programa.

Upgrade file phigs.js with adding option for output in window with DXF code, which is using in CAD modeling programs. With this option it is posible to export and use the Phigs picture in other programs. Also the term is, that the main program (the one which is using phigs.js) doesn't need to be changed a lot.




How to use DXF terminal

Before using a phigs DXG terminal, you have to ensure that you are using a new version of files:

	phigs.js
	phigs.jar
	

Also a new file is added:

	dxf.js
	

This file includes commands and variables for DXF terminal and needs to be copied on the same directory as phigs.js. Include it in your program with:

<SCRIPT language=javascript src=dxf.js> </script>
	

If you want results to be seen only in DXF terminal you don't define applet anymore (<APPLET code=phigs.class ....).

When opening a work station the change is in Connection ID, which is used in popen_ws(ws_ID, ConnID, ws_type). In this command variable ConnID means Connection ID. It needs to be defined as:

	ConnID = new dxf(width, height, dxf_version);
	

Arguments width and height are defining resolution in number of pixels. Dxf_version is defined as a number. It depend on which version of DXF file will be generated. The default values are:

	width = 500
	height = 500
	dxf_version = 12
	

Chosing dxf_version 14 of higher you get a new type of polyline generated in DXF file (LWPOLYLINE-2D instead of POLYLINE - 3D), which is used in AutoCAD version 14 or higher.
So if you want to chose Connection ID with default arguments define ConnID as:

	ConnID = new dxf();
	

It is also possible to generate 2 or more DXF file simply with opening a new workstation. Example:

	popen_ws(2, new dxf(), 12);
	                    // open Workstation No.2 (ws_ID = 2)
	

When DXF code is generated in a window it is needed to be saved as text file with DXF extension.

Emulaciji Phigs sem dodal opcijo za nov terminal ki se imenuje DXF. Kar pomeni, ob izbiri te opcije Phigs slike ne izrisuje na ekran (v Phigs applet) temveč v novo okno (DXF code) v obliki DXF kod.



DXF format (Drawing eXchange Format)

DXF je ime za podaljšek grafičnih datotek. Datoteke tega tipa uporabljamo za izmenjavo izrisov med različnimi grafičnimi programi (an. Exchange - slo. izmenjava). Izpiše se v obliki ASCII datoteke, torej je DXF datoteko možno brati kot običajno tekstovno datoteko. Primer programa:



0
SECTION
2
ENTITIES        - začetek vnosa elementov
0
POLYLINE        - risi črtovje
8               - določitev ravnine
0               - številka ravnine
62              - določitev barve
3               - indeks barve
10
0
20
30
0
VERTEX          - vozlišče
10              - določi x
12.5            - x = 12.5
20              - določi y
33.4            - y = 33.4
30              - določi z
0.0             - z = 0
VERTEX
10
42.32
20
10.0
30
0.0
0
TEXT            - tekst
8               - ravnina
0
7
4
10              - x koordinata pozicije teksta
250
20              - y koordinata pozicije teksta
250
30              - z koordinata pozicije teksta
0
40              - določi višino znakov
10.0            - visina znaka je 10.0
1
izpis           - tekst ki se izpise
62              - barva teksta
3
0
ENDSEC          - SECTION end
0
EOF             - konec datoteke

To je zelo preprost primer DXF datoteke, ki izriše črtoVJE (ukaz POLYLINE) in izpiše besedo (ukaz TEXT).

Pri novejših verzijah AutoCAD-a se namesto ukaza POLYLINE uporablja LWPOLYLINE (Light Weight Polyline). Ta ima le dve komponente in bi za zgoraj primer črte iz navedenega primera izgledala takole:

0
LWPOLYLINE      - riši Light Weight Polyline (2D)
 8              - določi risalno ravnino na kateri do črta
0               - številka ravnine
 62             - barva
7
 90             - določi število vozlišč
2               - število vozlišč je 2
 10
12.5            - x koordinata prvega vozlišča
 20
33.4            - y koordinata prvega vozlišča
 10
42.32           - x koordinata drugega vozlišča
 20
10.0            - y koordinata drugega vozlišča

Kot je razvidno iz primera je LWPOLYLINE bolj elegantna resitev, ker je zapis krajš. Ni potrebno namreč vedno znova označevati novega vozlišča temveč se samo izpisuje x in y komponente, prej pa je treba navesti število vozlišč. Seveda pa nekaj prostora tudi prihrani odsotnost z koordinate, odpadejo pa tudi ukazi za zaključek črtovja (ENDSEQ).

Iz zgoraj navedenega primera je razvidno, da je DXF datoteka zelo preprosta, vendar je branje le-te lahko zahtevno, če upoštevam, da ob sliki z veliko elementi in nastavitvami dobimo izjemno obširne datoteke.



---

Phigsu sem dodal opcijo za nov nacin prikaza rezultatov DXF. Kar pomeni, da ob izbiri te opcije Phigs slike ne izrisuje na ekran (v Phigs applet) temvec rezultat v obliki DXF kode izpiše v novo okno. V programu pa to izgleda tako, da se izpis rezultatov preusmeri iz dokumenta Phigs na dokument display, ki je definiran kot:

	dxf_window_number++;

	var w = window.open("", dxf_window_number, "width=300,height=650,status=no," +
							"location=no,toolbar=no,menubar=yes,"+
							"scrollbars=yes,resizable=yes");

	this.display = w.document.open("text/plain");     // opens display for writing
	

S spremenljivko dxf_window_number določimo ime okna. Ta podatek pri odpiranju okna sicer ne bi bil pomemben, a sem ga uvedel, ker se mora ob ponovnem odpiranju spremeniti (dxf_window_number++). S tem sem omogočil odpiranje večih oken hkrati(če bi bilo ime okna ob ponovnem odpiranju enako bi program ponovno uporabil že odprto okno)oziroma delo z več DXF delovnimi področji. (Primer 3).

Datoteka Phigs.js je pravzaprav ostala nespremenjena, razen v funkciji pclose_ws():

	function pclose_ws(ws_id)
	{
	  	phigs.close();
	}
	

S to spremembo, pa se je phigs v grafičnem okolju obnašal tako, da je sicer narisal vse elemente, vendar jih je tudi takoj pobrisal z ekrana. Z na novo implementirano verzijo datoteke phigs.jar pa je bil ta problem rešen.

Phigs.close() je v originalnem phigs.js bil označen kot komentar. Tokrat se izvede, ker se s funkcijo zaključi dokument z DXF kodo in na koncu zapre:

		this.close = function ()
	    {
			this.display.writeln("0\nENDSEC\n0\nEOF");
			this.display.close();
	    }
	

Zgoraj navedena funkcija pa se ne nahaja v Phigs.js, temveč v dodatni Java Script datoteki dxf.js, ki vsebuje funkcije za izbrani temrminal. Definicija naloge je sicer zahtevala, da se spremeni samo phigs.js, ostalo pa naj bi ostalo minimalno spremenjeno (koda programa, ki uporablja phigs ...). Toda z upoštevanjem tega je bilo nemogoče uporabljati DXF terminal, brez da bi se odprlo phigsovo grafično okno za izris rezultatov (applet). Torej za izpolnitev tega pogoja, je bilo potrebno izločiti vrstico, ki določi applet:

<APPLET CODE=phigs.class archive=phigs.jar name=Phigs width=500 height=500>    </APPLET>
	

Z ogledom zgornje vrstice sem hitro ugotovil, da z izločitvijo le-te izgubim pomembna podatka: width in height (višina in širina delovnega področja). To pa se uporablja tudi za določitev in zapis koordinat v rezultatsko okno. Zato je nastala datoteka dxf.js. Ki jo z naslednjo vrstico vključimo v program:

<script language=javascript src=dxf.js>   </script>
	

S tem, ko je vključena nova datoteka, je potrebno program, ki uporablja phigs nekoliko spremeniti. V kolikor uporabnik želi uporabnik uporabljati samo DXF terminal (brez grafike), je potrebno izločiti vrstico, ki določi applet. Delovno področje pa v tem primeru definiramo:

    ConnID = new dxf(širina, višina, Acad_Version);
    popen_ws = (ws_id , ConnID , WorkstnType);
	

To pa je tudi vse, kar mora uporabnik spremeniti v svojem programu. Kot delovno področje se torej prikaže okno. Ko phigs konča pisanje vanj, ga preprosto shranimo kot "Save As" pod imenom s končnico DXF. Datoteko je možno zagnati v AutoCad-u in drugih grafičnih programih.

Omogočena je tudi uporaba večih oken in s tem generiranje večih DXF datotek hkrati. Ta se odprejo preprosto z odprtjem novega delovnega področja: popen_ws(2, new(w, h), 14)

Če si se enkrat ogledamo vrstico, ki nam določa delovno področje vidimo, da se kot tretji argument tam pojavi Acad_Version. Ta je tipa številke, potreben pa je zato, da določimo vrsto generirane črte (polyline-a). Starejše verzije AutoCAD-a so namreč v DXF datotekah za izris črtovja uporabljale ukaz POLYLINE (in pa VERTEX za vpis vozlišč), s verzijo 14 pa ga je zamenjal ukaz LWPOLYLINE (Light Weight Polyline), ki uporablja le 2 dimeziji in ima nekoliko krajši zapis. Če torej za argument Acad_Version izberemo 14 se za izris črtovja uporabi LWPOLYLINE. V primeru, da vpišemo karkoli drugega oziroma pustimo prazno, se uporabi starejša različica črtovja.



Barve v DXF terminalu

Za uporabnika se na področju določanja barv teksta in črt ne spremeni nič, v programu dxf.js, pa jih je bilo potrebno posebej določiti. Izbrati je bilo torej treba indeks za barvo. To izvede funkcija get_aci(red, green, blue). Argumenti v tej funkciji so komponente barvne palete, ki jo ima določena barva v phigs-u. Ta funkcija na začetku vsebuje tabelo za barvno paleto AutoCAD-a za vseh 255 barv. Phigs ima sicer definiranih samo pet barv, toda v primeru da se pojavi katera koli nova barva, nadgradnja dxf.js ne bo potrebna. Glede na dobljene komponente (red,green,blue) v paleti izbere ustrezno AutoCAD-ovo barvo, ali tej najbolj podobno. Podobnost barv pa se lahko ugotovi za računanjem razdalje med barvami (predpostavimo, da je red-x, green-y, blue-z in računamo razdaljo med točkama v prostoru). S for program zanko torej za vsako izmed barv iz definirane palete izračuna razdaljo in na koncu vrne indeks barve z najmanjšo razdaljo oziroma razdaljo 0 (v primeru ko se barvni paleti popolnoma ujemata). Dobljeni indeks pa je torej tisti, ki se zapisuje v DXF datoteko.



Nadgradnja

Poleg že omenjenih sprememb, ki jih je potrebno postoriti v programu za uporabo DXF terminala, je treba tudi naloziti novi verziji datotek:

	phigs.js  in
	phigs.jar
	

Z uporabo starih verzij se DXF koda ne bo v celoti izpisala v okno.

V naslednjih primerih je uporabljen nadgrajen phigs. V vsakem programu s klikom na tipko 'Generate DXF'


• Simple One Line demo
• Multiple lines and external data file
• Multiple workstation windows
  
  

  ---

  
  
  

Seminar je pa zahteval nekoliko več časa kot sem pričakoval, ker sem prirejal datoteko phigs.js na nov terminal, nato pa se je izkazalo, da s tem načinom ni mogoče odstraniti phigs-ovega grafičnega applet-a. Prvotna definicija naloge torej ni bila izpolnjena (nadgraditev datoteke phigs.js tako, da originalni program minimalno spremenimo), ker je phigs spremenjen le minimalno, dodana pa nova datoteka. Toda mislim, da je s tem načinom naknadno nadgrajevanje Phigs-a enostavnejsše.



---

- Owen Ransen, AutoCAD programming in C/C++ (Vir: CTK)

Avtor: Marin Andrej

Mentor: mag. Leon Kos