GRA FILL

📝 Hinweise aus dem Handbuch

• 🔀Diese Routine ist auf Firmware V1.0 nicht verfügbar.
• Der Füllalgorithmus behandelt Pixel, die auf die aktuelle Stiftfarbe gesetzt sind, und Pixel, die auf die zum Füllen verwendete Farbe gesetzt sind, als Begrenzungen des Bereichsrands. Die Füllfarbe und die Stiftfarbe können dieselbe Farbe sein.
• Pixel, die gefüllt werden, werden auf die Füllfarbe gesetzt. Der Grafikschreibmodus beeinflusst nicht die Art und Weise, wie Pixel beim Füllen geschrieben werden.
• Der Füllalgorithmus bewegt sich nur nach oben, unten, rechts oder links. Er bewegt sich nicht diagonal, und daher wird der Algorithmus nicht durch eine Lücke zwischen diagonal benachbarten Randpixeln 'entweichen'. Das bedeutet, dass der Rand mit den normalen Linien begrenzt werden kann, die vom Graphics VDU gezeichnet werden.
• Der Füllalgorithmus vermeidet Rekursion. Stattdessen speichert er 'interessante Punkte', Stellen, an denen der Algorithmus eine Route zum Füllen gewählt hat, aber eine andere Route hätte wählen können, in dem vom Benutzer bereitgestellten Puffer. Der Puffer kann sich irgendwo im RAM befinden. Jeder gespeicherte 'interessante Punkt' belegt 7 Bytes des Puffers, und es gibt einen Overhead von 1 Byte, der zum Markieren des Pufferendes verwendet wird. Ein 64 Bytes langer Puffer ermöglicht also das Speichern von 9 'interessanten Punkten', was für die Füllung der meisten einfachen Bereiche ausreichen sollte.
• Form, desto länger muss der Puffer für 'interessante Punkte' sein.
• Die Fehlerrückgabe dieser Routine kann aus drei Gründen auftreten. Erstens könnte die aktuelle Grafikposition außerhalb des Fensters liegen. Zweitens könnte das Pixel an der aktuellen Grafikposition Rand sein (Stift- oder Fülltinte). In diesen Fällen kehrt die Routine zurück, ohne etwas zu füllen. Drittens könnte der Algorithmus den Puffer für 'interessante Punkte' erschöpfen, in welchem Fall ein Teil des Bereichs nicht gefüllt wird.

🔀 markiert: Unterschiede zwischen Firmware V1.0 (464) und V1.1 (664/6128).