RealContainer

class labpyproject.core.pygame.core.RealContainer(create_surface=True, **kwargs)

Bases : labpyproject.core.pygame.core.VirtualContainer, pygame.sprite.LayeredDirty

Container « réel » disposant de sa surface de publication pygame et des capacités de gestion des z-indexs via l’utilisation d’un LayerManager par composition. Pour sa descendance cet objet est vu comme un container, pour son parent il est considéré comme un objet terminal (ses couches internes sont applaties sur sa surface de publication).

Constructeur

Paramètres

• create_surface (boolean) – création de la surface de publication dès l’initialisation.

• **kwargs – peut contenir toutes les propriétés de VirtualContainer.

Attributes Summary

visible

Visibilité (bool)

Methods Summary

active_layer(layer)	Active une couche par l’ajout d’un sprite invisible.
add_child_to_displaylist(child)	Appelée lors de _add_item_internal, child est un VirtualItem.
add_from_hierarchy(childlist)	Chaine de remontée des items à publier en direction du RealContainer (aka self).
add_item(*childs, **kwargs)	Ajout d’un ou plusieurs item(s) virtuel(s).
clean_voidsprites()	Supprime les sprites d’activation.
create_background()	Annule le comportement de VirtualContainer : le fond monochrome est directement associé à la surface de publication.
create_publication_surface()	Crée la surface de publication.
discard_placement()	La position a été modifiée, le rendu graphique dans la surface de publication du RealContainer assurant la publication n’est plus valable.
discard_publication_surface()	Invalide la surface de publication.
doswap_layers(oldlayer, newlayer)	Echange les zindexs de deux couches.
draw_display()	Dessine ou redessine l’objet.
get_clear_surface()	Retourne la surface équivalente au fond d’un VirtualContainer, utilisée en clear par LayeredDirty.
get_clipping_rect()	Retourne le rect de clipping, par défaut self.borderRect.
get_publication_sprite()	Retourne le DirtySprite de publication.
get_pygame_surface()	Retourne la surface pygame du sprite de publication.
get_void_sprite()	Crée un sprite invisible pour l’activation d’une couche.
handle_display()	Gère l’affichage du RealContainer.
manage_publicationlist()	Ajoute/retire les items en attente.
on_bgcolor_changed()	Surcharge de VirtualContainer : discard la surface de publication.
on_child_display_discarded(child)	Chaine de remontée des discard d’update jusqu’au prochain RealContainer.
on_publicationRect_coords_changed(aftersnap)	Appelée lors du process de resize quand les coordonnées seules de publicationRect ont été modifiées (pas les dimensions).
on_publicationRect_dims_changed(aftersnap)	Appelée lors du process de resize quand les dimensions (et éventuellement les coords) de publicationRect ont été modifiées.
remove_child_from_displaylist(child)	Appelée lors de _remove_item_internal, child est un VirtualItem.
remove_from_hierarchy(childlist)	Chaine de remontée des items à supprimer en direction du RealContainer (aka self).
remove_item(*childs)	Suppression d’un ou plusieurs item(s) virtuel(s).
update(*args)	Appelée à chaque frame:
update_publication_surface()	Re crée la surface de publication.
xforce_update()	Force le redraw de tous les sprites de la displaylist.
xget_childs([context])	Retourne la liste de tous les items de la hiérarchie

Attributes Documentation

visible

Visibilité (bool)

Methods Documentation

active_layer(layer)

Active une couche par l’ajout d’un sprite invisible.

add_child_to_displaylist(child)

Appelée lors de _add_item_internal, child est un VirtualItem.

add_from_hierarchy(childlist)

Chaine de remontée des items à publier en direction du RealContainer (aka self).

add_item(*childs, **kwargs)

Ajout d’un ou plusieurs item(s) virtuel(s).

clean_voidsprites()

Supprime les sprites d’activation.

create_background()

Annule le comportement de VirtualContainer : le fond monochrome est directement associé à la surface de publication.

create_publication_surface()

Crée la surface de publication.

discard_placement()

La position a été modifiée, le rendu graphique dans la surface de publication du RealContainer assurant la publication n’est plus valable. Par contre le rendu « local » de cet objet reste valide.

discard_publication_surface()

Invalide la surface de publication.

doswap_layers(oldlayer, newlayer)

Echange les zindexs de deux couches.

draw_display()

Dessine ou redessine l’objet.

get_clear_surface()

Retourne la surface équivalente au fond d’un VirtualContainer, utilisée en clear par LayeredDirty.

get_clipping_rect()

Retourne le rect de clipping, par défaut self.borderRect.

get_publication_sprite()

Retourne le DirtySprite de publication.

get_pygame_surface()

Retourne la surface pygame du sprite de publication.

get_void_sprite()

Crée un sprite invisible pour l’activation d’une couche.

handle_display()

Gère l’affichage du RealContainer. Retourne le nombre de childs retracés.

manage_publicationlist()

Ajoute/retire les items en attente.

on_bgcolor_changed()

Surcharge de VirtualContainer : discard la surface de publication.

on_child_display_discarded(child)

Chaine de remontée des discard d’update jusqu’au prochain RealContainer.

on_publicationRect_coords_changed(aftersnap)

Appelée lors du process de resize quand les coordonnées seules de publicationRect ont été modifiées (pas les dimensions).

Paramètres

aftersnap (boolean) – True si consécutif à un calcul de snap, False sinon

on_publicationRect_dims_changed(aftersnap)

Appelée lors du process de resize quand les dimensions (et éventuellement les coords) de publicationRect ont été modifiées.

Paramètres

aftersnap (boolean) – True si consécutif à un calcul de snap, False sinon

remove_child_from_displaylist(child)

Appelée lors de _remove_item_internal, child est un VirtualItem.

remove_from_hierarchy(childlist)

Chaine de remontée des items à supprimer en direction du RealContainer (aka self).

remove_item(*childs)

Suppression d’un ou plusieurs item(s) virtuel(s).

update(*args)

Appelée à chaque frame:

1. Publications éventuelles

2. Resize générique

3. Mise à jour du display

update_publication_surface()

Re crée la surface de publication.

xforce_update()

Force le redraw de tous les sprites de la displaylist.

xget_childs(context='publication')

Retourne la liste de tous les items de la hiérarchie

Paramètres

context (str) – permet de spécifier le contexte d’usage (par défaut « publication »)