Konwersja Library - Wersja 2.0 ============================== WAŪNE ----- Pakiet ten zawiera include'y, dokumentacjė oraz przykīadowy program demonstracyjny wraz z kodem śródīowym w jėzyku C dla biblioteki 'konwersja.library'. AUTORZY ------- Grzegorz Królik - definicje standardów, kodowanie biblioteki, przykīadowy program Konwerter. PRAWA AUTORSKIE --------------- Pakiet ten rozprowadzany jest na zasadzie Shareware. Oznacza to, ūe powinien on byź rozpowszechniany w caīoōci, a uūytkownik chcācy skorzystaź z jakiejkolwiek jego czėōci powinien zastosowaź siė do poniūszych warunków: 1) Jeōli jesteō autorem bezpīatnie rozpowszechnianego programu (Public Domain, Freeware), który uūywa 'konwersja.library' to wyraūam zgodė na zamieszczenie w pakiecie z tym programem wybranych plików (np. samej tylko biblioteki). 2) W przypadku produktu komercyjnego (lub programu Shareware) równieū wyraūam zgodė na zamieszczenie w pakiecie wybranych plików, ale chciaībym otrzymaź kopiė tego programu w peīnej wersji. Jednoczeōnie zobowiāzujė siė nie rozprowadzaź otrzymanego pakietu ani ūadnej jego czėōci. Bez wzglėdu na to, czy Twój program to produkt rozprowadzany bezpīatnie czy komercyjny to w dokumentacji do tego programu (lub w samym programie) powinna znaleśź siė adnotacja o wykorzystaniu przez program biblioteki 'konwersja.library', której autorem jest Grzegorz Królik. Przykīadowy program demonstracyjny oraz pozostaīe pliki znajdujāce siė w katalogu 'KonwersjaLib/Przykīad' rozpowszechniane sā na zasadzie Public Domain. Mogā one byź dowolnie zmieniane i wykorzystywane do wīasnych celów. Nie wolno natomiast rozprowadzaź ich w zmodyfikowanej formie wraz z pakietem 'Konwersja Library'. WPROWADZENIE ------------ Zapewne kaūdy uūytkownik Amigi spotkaī siė z plikami tekstowymi napisanymi w róūnych standardach. Jednak co zrobiź jeōli potrzebny nam jest plik tekstowy, ale napisany w innym standardzie? Potrzebny jest program konwertujācy. A co jeōli ten nie oferuje potrzebnych nam standardów? Wtedy z pomocā przychodzi ta biblioteka. ZALETY ------ Pakiet ten skīada siė z biblioteki, która pozwala nie tylko konwertowaź pliki pomiėdzy róūnymi standardami (Amiga, IBM PC), ale takūe posiada moūliwoōź rozpoznania standardu w jakim napisany jest plik tekstwy. 'konwersja.library' to standardowa biblioteka. Wspóīpracuje z Kickstartem 1.3+. Ponadto biblioteka ta oferuje uūytkownikowi specialny interfejs, tzn. uūytkownik moūe otrzymywaź wiadomoōci takie jak: wielkoōź bufora, wielkoōź danych juū przekonwertowanych, itd. Podobny interfejs posiada biblioteka 'powerpacker.library', której autorem jest Nico Franēois. DO UŪYTKOWNIKA -------------- Jeōli stworzyīeō nowe definicje standardów, które nie sā ujėte w tym pakiecie przyōlij je do mnie, a ja umieszczė je w kolejnej wersji pakietu 'Konwersja Library'. Wszystkie listy kieruj na adres: Grzegorz Królik ul. Wyszyļskiego 8/19 42-400 Zawiercie tel. (0-32) 672-32-53 e-mail: gkrolik@poczta.onet.pl PODZIĖKOWANIA ------------- Podziėkowania naleūā siė Tomaszowi Bieliļskiemu (Siumot/BlaBla) za ogromny wkīad w dalszy rozwój i obecny ksztaīt biblioteki. HISTORIA -------- konwersja.library 1.0 (8.7.97) - Moūliwoōź automatycznego rozpoznania standardu - Szybka konwersja pliku tekstowego, ok. 40 KB/sek. - Biblioteka posiada wbudowane 5 standardów - Dodatkowe 8 standardów jest rozpowszechniane wraz z bibliotekā - Doīāczony przykīadowy kod śródīowy w jėzyku 'C' konwersja.library 1.1 (28.7.97) A NIECH TO!!! - W niecaīy miesiāc po wypuszczeniu wersji 1.0 zauwaūyīem POWAŪNY bīād w dokumentacji do biblioteki. Bīād polegaī na tym, ūe podaīem bīėdnie rozpiskė dla funkcji Konwertuj(). Dokīadniej mówiāc parametr 'atrybuty' powinien zostaź podany po 'nowyrozmiar' i znajdowaź siė przed 'zrodlowy'. Na szczėōcie bīād ten poprawiīem (patrz dokumentacja) i mam nadziejė, ūe nikomu on juū nie sprawi kīopotu. Przepraszam za wszystko! - Kod biblioteki zostaī skrócony i zoptymalizowana zostaīa funkcja RozpoznajStandard() oraz skrócona funkcja Konwertuj(). - Poprawiīem include'y, które prawdopodobnie takūe zawieraīy bīād. - Dodaīem przykīadowy kod śródīowy w asemblerze i poprawiīem bīėdy w kodzie śródīowym w jėzyku 'C'. Chodzi o to, ūe uūyīem funkcji intuition.library/SetWindowPointerA(), która dostėpna jest dopiero w wersji 39 biblioteki Intuition, a wiėc nie moūliwe byīo dziaīanie tego przykīadu od systemu 2.04. konwersja.library 1.2 (1.8.97) NO NIE, ZNOWU POPEĪNIĪEM BĪĀD!!! - W dokumentacji do poprzedniej wersji zapomniaīem dodaź bardzo waūnā informacjė dotyczācā funkcji Konwertuj(). Patrz 'WAŪNE'. konwersja.library 1.3 (23.4.98) POPRAWIĪEM NIEWIELKI BĪĀD!!! - Kiedy podczas īadowania standardów biblioteka napotka na inny standard o tej samej nazwie, to nie powinien on zostaź juū zaīadowany. To zabezpieczenie zostaīo wprowadzone od wersji 1.0, ale dziaīaīo tylko w przypadku, gdy nazwa standardu skīadaīa siė z 8 liter. konwersja.library 1.4 (17.9.98) POPRAWIĪEM KILKA DROBNYCH BĪĖDÓW!!! - Nie do koļca zostaī wyeliminowany bīād z poprzedniej wersji. Gdy nazwa īadowanego standardu byīa czėōciā nazwy innego standardu, wtedy ten standard równieū nie byī īadowany. Np. standard o nazwie 'Amiga' nie zostaīby zaīadowany gdyū istnieje juū 'Amiga PL'. - Biblioteka ma bardziej rozbudowanā obsīugė bīėdów w skīadni standardu. Jeōli plik z definicjā standardu posiada jakiō bīād, to nie zostanie on wczytany. Typowe bīėdy to brak zamykajācego nazwė cudzysīowu, dwa przecinki obok siebie, niekompletna definicja kodów, itd. konwersja.library 2.0 (28.12.99) - Do biblioteki zostaīy dodane trzy nowe funkcje: AnalizujBufor(), PobierzNazwe(), PobierzNumer(). - Funkcja RozpoznajStandard() zostaīa skrócona oraz zoptymalizowana. - Doīāczony zostaī przykīadowy program demonstracyjny wraz z kodem śródīowym w jėzyku 'C'. Do uruchomienia programu demonstracyjnego wymagany jest system 2.04+.