<?xml version="1.0" encoding="utf-8"?>
<page xmlns="http://projectmallard.org/1.0/" xmlns:its="http://www.w3.org/2005/11/its" xmlns:xi="http://www.w3.org/2001/XInclude" type="guide" style="task" id="widget_drawing.py" xml:lang="sv">
  <info>
    <title type="text">Widget (Python)</title>
    <link type="guide" xref="beginner.py#misc"/>
    <revision version="0.1" date="2013-02-24" status="stub"/>

    <credit type="author copyright">
      <name>Marta Maria Casetti</name>
      <email its:translate="no">mmcasetti@gmail.com</email>
      <years>2013</years>
    </credit>

    <desc>En komponent som använder Cairo-biblioteket för utritning</desc>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Sebastian Rasmussen</mal:name>
      <mal:email>sebras@gmail.com</mal:email>
      <mal:years>2019</mal:years>
    </mal:credit>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Anders Jonsson</mal:name>
      <mal:email>anders.jonsson@norsjovallen.se</mal:email>
      <mal:years>2021</mal:years>
    </mal:credit>
  </info>

  <title>Widget</title>
  <media type="image" mime="image/png" src="media/widget_drawing.png"/>
  <p>Ange en vinkel, visualisera den.</p>

  <links type="section"/>

  <section id="code">
  <title>Kod som använts för att generera detta exempel</title>

  <code mime="text/x-python" style="numbered">from gi.repository import Gtk
from gi.repository import cairo
import sys
import math


class MyWindow(Gtk.ApplicationWindow):

    def __init__(self, app):
        Gtk.Window.__init__(self, title="Välj en vinkel", application=app)
        self.set_default_size(400, 400)
        self.set_border_width(10)

        # en standardvinkel
        self.angle = 360

        grid = Gtk.Grid()

        # en stegningsruta som använder ett värde som vinkel
        ad = Gtk.Adjustment(360, 0, 360, 1, 0, 0)
        self.spin = Gtk.SpinButton(adjustment=ad, climb_rate=1, digits=0)
        self.spin.connect("value-changed", self.get_angle)

        # en rityta för att rita vad vi vill
        self.darea = Gtk.DrawingArea()
        # som vi beskriver i metoden draw(), ansluten till signalen ”draw”
        self.darea.connect("draw", self.draw)
        # vi måste begära en minsta storlek för ritytan, annars försvinner den
        self.darea.set_size_request(300, 300)

        grid.attach(self.spin, 0, 0, 1, 1)
        grid.attach(self.darea, 0, 1, 1, 1)

        self.add(grid)

    # närhelst vi får en ny vinkel i stegningsrutan
    def get_angle(self, event):
        self.angle = self.spin.get_value_as_int()
        # rita om det som finns i ritytan
        self.darea.queue_draw()

    def draw(self, darea, cr):
        # en 10 bildpunkter bred linje
        cr.set_line_width(10)
        # röd
        cr.set_source_rgba(0.5, 0.0, 0.0, 1.0)

        # få bredden och höjden på ritytan
        w = self.darea.get_allocated_width()
        h = self.darea.get_allocated_height()

        # gå till mitten på ritytan
        # (translatera från övre vänstra hörnet till w/2, h/2)
        cr.translate(w / 2, h / 2)
        # rita en linje till (55, 0)
        cr.line_to(55, 0)
        # och gå tillbaka till (0, 0)
        cr.line_to(0, 0)
        # rita en båge centrerad i origo, 50 bildpunkter bred, från vinkel 0
        # (i radianer) till vinkeln angiven av stegningsrutan (i grader)
        cr.arc(0, 0, 50, 0, self.angle * (math.pi / 180))
        # rita en linje tillbaka till origo
        cr.line_to(0, 0)
        # ritar banan, och behåller banan för framtida användning
        cr.stroke_preserve()

        # ställ in en färg
        cr.set_source_rgba(0.0, 0.5, 0.5, 1.0)
        # och använd den för att fylla banan (som vi hade behållit)
        cr.fill()


class MyApplication(Gtk.Application):

    def __init__(self):
        Gtk.Application.__init__(self)

    def do_activate(self):
        win = MyWindow(self)
        win.show_all()

    def do_startup(self):
        Gtk.Application.do_startup(self)

app = MyApplication()
exit_status = app.run(sys.argv)
sys.exit(exit_status)
</code>

  </section>
  
  <section id="references">
  <title>API-referenser</title>
  <p>I detta exempel använde vi följande:</p>
  <list>
    <item><p><link href="http://developer.gnome.org/gtk3/unstable/GtkWidget.html">GtkWidget</link></p></item>
    <item><p><link href="http://developer.gnome.org/gtk3/unstable/GtkDrawingArea.html">GtkDrawingArea</link></p></item>
    <item><p><link href="http://www.tortall.net/mu/wiki/CairoTutorial">Cairo-handledningen för Python-programmerare</link></p></item>
  </list>
  </section>
</page>
