Create: Computing AgesDoc Brass
Périphériques

Caméra

Une caméra de surveillance : un ordinateur affiche en direct ce qu'elle voit sur son écran, à la taille qu'il veut, et tourne sa tête en haut, en bas, à gauche et à droite.

La caméra est la caméra de télévision en circuit fermé d'un poste de garde : un ordinateur affiche ce qu'elle voit sur son propre écran, et sur les moniteurs qui montrent cet écran, et tourne sa tête pour regarder ailleurs. L'image est le monde tel que le jeu le dessine, en direct, avec ses textures, sa lumière, son ciel et tout ce qui bouge : un seul appel l'ouvre, à la taille et à l'endroit que vous choisissez, et elle reste en direct toute seule.

Brass
local cam = peripheral.find("camera")
term.clear()
cam.draw()  -- ce que voit la caméra, en direct, sur tout l'écran
Méthodes
cam.draw([x, y [, w, h]])Affiche ce que voit la caméra, en direct, sur l'écran de l'ordinateur, dans le rectangle de pixels que vous donnez.
cam.hide()Retire l'image de cette caméra de l'écran. gfx.clear() retire toutes les caméras, avec le dessin.
cam.turn(yaw [, pitch])Tourne la tête depuis là où elle pointe.
cam.set_angle(yaw, pitch)Oriente la tête, où qu'elle pointait avant.
cam.angle()Où pointe la tête maintenant. La tête garde son angle quand le programme se termine, et quand le monde est sauvegardé.

Installation

La poser. La caméra se fixe sur la face que vous cliquez. Sur un mur, elle regarde hors du mur ; au sol ou au plafond, elle regarde vers vous. De là, sa tête fait le tour complet, à gauche et à droite, et va de tout en bas à tout en haut. Une clé de Create tourne toute la caméra d'un quart de tour.

L'atteindre depuis un ordinateur. Posez-la contre une face de l'ordinateur (peripheral.wrap("top")), ou contre le câble de données de l'ordinateur, à partir du Mini-ordinateur : elle porte alors le nom de ses coordonnées, comme camera@120,64,-35, et un seul câble amène les caméras de toute une base à un poste de garde. peripheral.find("camera") prend la première, peripheral.list("camera") les nomme toutes. Voir Périphériques.

Ce qu'elle montre. Le monde comme vous le voyez dans le jeu : les blocs avec leurs textures, la lumière du jour, de la nuit et des torches, l'eau, le ciel et la météo, les joueurs, les créatures, les objets au sol et les machines de Create qui tournent. Elle voit 70 degrés sur le plus long côté de son rectangle, et à 96 blocs. Le jeu de chaque joueur dessine l'image, avec ce qu'il a chargé : une caméra plus loin du joueur que sa distance d'affichage montre PAS DE SIGNAL.

Les couleurs. Chaque écran montre l'image du mieux qu'il peut :

écranl'image
Ordinateur moderne, Moniteur LCD (quel que soit l'ordinateur)telle que le jeu la dessine, dans ses vraies couleurs
Micro-ordinateur, Microcontrôleur, et un Moniteur cathodique branché sur euxchaque pixel dans la plus proche des 16 couleurs
Ordinateur à transistors, Mini-ordinateur (phosphore vert et ambre)en quatre nuances de la lueur du phosphore
Calculateur à tubesaucune : il imprime sur papier, et draw arrête le programme

Ce qu'elle coûte. Rien au programme et rien au serveur : le serveur dit seulement aux jeux des joueurs quelle caméra va où sur l'écran. Chaque jeu redessine le monde pour chaque caméra d'un écran qu'il regarde (le terminal ouvert, ou des moniteurs en vue), jusqu'à 30 images par seconde chacune : une caméra que personne ne regarde ne coûte rien. Chaque joueur peut changer jusqu'où les caméras voient, à quelle fréquence et à quelle finesse elles sont dessinées, dans la configuration du client (viewDistance, frameRate, resolution). Les images ne sont pas dessinées quand Sodium, Embeddium, Iris ou Oculus est installé.

Afficher ce qu'elle voit

#

cam.draw([x, y [, w, h]])

Affiche ce que voit la caméra, en direct, sur l'écran de l'ordinateur, dans le rectangle de pixels que vous donnez.

Paramètres
x number facultatif
le bord gauche, en pixels de l'écran à partir de 1 ; 1 s'il est omis
y number facultatif
le bord du haut ; 1 s'il est omis
w number facultatif
la largeur en pixels ; jusqu'au bord droit de l'écran si elle est omise
h number facultatif
la hauteur en pixels ; jusqu'en bas de l'écran si elle est omise

L'image se place au-dessus du fond du texte et sous le dessin gfx et les caractères : effacez d'abord le texte avec term.clear(). L'ouvrir efface le dessin dans son rectangle ; ce que vous dessinez par-dessus ensuite reste devant, un viseur ou une légende. Elle reste en direct quand le programme se termine, jusqu'à cam.hide() ou gfx.clear(). Les parties du rectangle hors de l'écran sont coupées. Rappeler draw avec un autre rectangle déplace l'image ; avec le même, cela ne fait rien. Un écran montre quatre caméras au plus.

Brass
local cam = peripheral.find("camera")
term.clear()
cam.draw(1, 1, 192, 108)  -- le quart en haut à gauche d'un Ordinateur moderne

En cas d'échec :

  • sur un Calculateur à tubes : a camera needs a screen with pixels: the Tube Computer prints on paper ;
  • avec quatre autres caméras à l'écran : a screen shows 4 cameras at most: hide one first ;
  • quand la caméra a été cassée : camera removed.

Voir aussi camera.hide() camera.turn() gfx

#

cam.hide()

Retire l'image de cette caméra de l'écran. gfx.clear() retire toutes les caméras, avec le dessin.

Voir aussi camera.draw()

Tourner la tête

Les angles sont en degrés depuis tout droit devant le support : le lacet (yaw) va de -180 à 180, vers la droite (négatif vers la gauche), le tangage (pitch) de -90 (tout en bas) à 90 (tout en haut). La tête tourne tout de suite pour le programme, et les joueurs la voient pivoter en un quart de seconde, l'image avec elle.

#

cam.turn(yaw [, pitch])

Tourne la tête depuis là où elle pointe.

Paramètres
yaw number
les degrés à tourner vers la droite ; négatif vers la gauche
pitch number facultatif
les degrés à tourner vers le haut ; négatif vers le bas ; 0 s'il est omis

Au-delà de 180 degrés, le lacet repart de -180 : la tête fait des tours complets. Le tangage s'arrête à tout en haut et tout en bas.

Brass
local cam = peripheral.find("camera")
cam.turn(-15)    -- un peu à gauche
cam.turn(0, 10)  -- un peu vers le haut

Un mauvais angle (un texte, un nombre qui n'est pas fini comme 0 / 0) arrête le programme avec bad argument #1 to 'turn' (...).

Voir aussi camera.set_angle() camera.angle()

#

cam.set_angle(yaw, pitch)

Oriente la tête, où qu'elle pointait avant.

Paramètres
yaw number
les degrés vers la droite depuis tout droit, de -180 à 180
pitch number
les degrés vers le haut, de -90 à 90
Brass
cam.set_angle(0, 0)     -- tout droit
cam.set_angle(90, -30)  -- à droite, vers le bas

Un lacet au-delà de 180 est ramené entre -180 et 180 (270 donne -90) ; un tangage au-delà de 90 donne 90.

Voir aussi camera.turn() camera.angle()

#

cam.angle()

→ table

Où pointe la tête maintenant. La tête garde son angle quand le programme se termine, et quand le monde est sauvegardé.

Renvoie
table
{yaw = degrés vers la droite, pitch = degrés vers le haut}
Brass
local a = cam.angle()
print("lacet " .. a.yaw .. ", tangage " .. a.pitch)

Voir aussi camera.turn() camera.set_angle()

Exemples

Un poste de garde aux flèches du clavier

L'image est en direct toute seule : le programme attend seulement les flèches, et tourne la caméra.

Brass
local cam = peripheral.find("camera")
term.clear()
cam.draw()
while true do
  local e = os.pull_event("key")
  if e.key == "left" then cam.turn(-10) end
  if e.key == "right" then cam.turn(10) end
  if e.key == "up" then cam.turn(0, 10) end
  if e.key == "down" then cam.turn(0, -10) end
end

Sur un mur de Moniteurs LCD contre l'ordinateur, tout le poste de garde suit l'image en vraies couleurs.

Quatre caméras sur un écran

Quatre caméras sur le câble de données de l'ordinateur, chacune dans un quart de l'écran.

Brass
local s = gfx.size()
local w, h = math.floor(s.w / 2), math.floor(s.h / 2)
term.clear()
for i, nom in ipairs(peripheral.list("camera")) do
  if i <= 4 then
    local col, ligne = (i - 1) % 2, math.floor((i - 1) / 2)
    peripheral.wrap(nom).draw(1 + col * w, 1 + ligne * h, w, h)
  end
end

Le programme peut se terminer : les quatre images restent en direct à l'écran.

Une légende sur l'image

Ce que gfx dessine après l'image reste devant elle : ici le nom de la caméra et l'heure du jour, redessinés chaque seconde.

Brass
local cam = peripheral.find("camera")
term.clear()
cam.draw()
while true do
  local t = os.day_time()
  local heure = string.format("%02d:%02d", (t // 1000 + 6) % 24, t % 1000 * 60 // 1000)
  gfx.rect(1, 1, 48, 9, "black", true)
  gfx.text(3, 3, "PORTE " .. heure, "red")
  sleep(1)
end