Live Object Model Français

  • Application
      Cette classe représente l’application Live. Elle est accessible par le chemin racine live_app.
      Chemin d’accès: live_app
    • Enfants
      • view
          TYPE : Application.View
          ACCES : get
          DESCRIPTION :
      • control_surfaces
          TYPE : liste de ControlSurface
          ACCES : get, observe
          DESCRIPTION : Une liste des surfaces de contrôle actuellement sélectionnées dans les Préférences de Live. Si Aucun est sélectionné dans l’un des emplacements ou si le script est inactif (par exemple, lorsque Push2 est sélectionné, mais qu’aucun Push n’est connecté), id 0 sera renvoyé à ces index.
    • Propriétés
      • current_dialog_button_count
          TYPE : int
          ACCES : get
          DESCRIPTION : Le nombre de boutons dans la boîte de message actuelle.
      • current_dialog_message
          TYPE : symbol
          ACCES : get
          DESCRIPTION : Le texte de la boîte de message actuelle (vide si aucune boîte de message n’est actuellement affichée).
      • open_dialog_count
          TYPE : int
          ACCES : get, observe
          DESCRIPTION : Le nombre de boîtes de dialogue affichées.
    • Fonctions
  • Application.View
      Cette classe représente les aspects de l’application Live liés à l’affichage de l’application.
      Chemin d’accès: live_app view
    • Enfants
        Aucun
    • Propriétés
      • browse_mode
          TYPE : bool
          ACCES : get, observe
          DESCRIPTION : 1 = Le mode de remplacement à chaud est actif pour toutes les cibles.
      • focused_document_view
          TYPE : unicode
          ACCES : get, observe
          DESCRIPTION : Nom de la vue actuellement visible dans la fenêtre Live ayant le focus («Session» ou «Arranger»).
    • Fonctions
      • available_main_views
          Renvoie : nom de vue [liste de symboles]. Il s’agit d’une liste de noms de vue constante à utiliser comme argument lors de l’appel d’autres fonctions: Browser Arranger Session Detail Detail/Clip Detail/DeviceChain .
      • focus_view
          Paramètre : view_name Affiche la vue nommée et met le focus dessus. Vous pouvez également passer un view_name vide «  », qui fait référence à la vue Arrangement ou Session (selon ce qui est visible dans la fenêtre principale).
      • hide_view
          Paramètre : view_name Masque la vue nommée. Vous pouvez également passer un view_name vide «  », qui fait référence à la vue Arrangement ou Session (selon ce qui est visible dans la fenêtre principale).
      • is_view_visible
          Paramètre : view_name Renvoie : [bool] Indique si la vue spécifiée est actuellement visible.
      • scroll_view
          Paramètres : direction view_name modifier_pressed direction [int] 0 = haut, 1 = bas, 2 = gauche, 3 = droite modifier_pressed [bool] Si view_name est « Arranger » et modifier_pressed est 1 et la direction est à gauche ou à droite, la taille de la région temporelle sélectionnée est modifiée, sinon la position du curseur de lecture est déplacée. Toutes les vues ne peuvent pas scroller et pas dans toutes les directions. Actuellement, seules les vues Arrangeur, Navigateur, Session et Détail / Chaîne de périphériques peuvent scroller. Vous pouvez également passer un nom_vue vide «  », qui fait référence à la vue Arrangement ou Session (selon la vue visible).
      • show_view
          Paramètre : view_name
      • toggle_browse
          Affiche la chaîne de périphériques et le navigateur et active le mode de remplacement à chaud pour le périphérique sélectionné. Le fait d’appeler à nouveau cette fonction désactive le mode de remplacement à chaud.
      • zoom_view
          Paramètre : direction view_name modifier_pressed direction [int] – 0 = haut, 1 = bas, 2 = gauche, 3 = droite modifier_pressed [bool] Si view_name est ‘Arrangement’, modifier_pressed est 1 et la direction est à gauche ou à droite, alors la taille de la région temporelle sélectionnée est modifiée, sinon la position du curseur de lecture est déplacée. Si view_name est Arrangement et modifier_pressed est 1 et la direction est vers le haut ou vers le bas, alors seule la hauteur de la piste en surbrillance est modifiée, sinon la hauteur de toutes les pistes est modifiée. Seules les vues Arrangement et Session peuvent être agrandies. Pour la vue de Session, le comportement de zoom_view est identique à scroll_view. Vous pouvez également passer un nom_vue vide «  », qui fait référence à la vue Arrangement ou Session (selon ce qui est visible dans la fenêtre principale).
  • Song
      Cette classe représente un Live Set. Le Live Set actuel est accessible par le chemin live_set.
      Chemin d’accès : live_set
    • Enfants
      • cue_points
          TYPE : liste de CuePoint
          ACCES : get, observe
          DESCRIPTION : Les Cue points sont les repères de l’Arrangement auxquels vous pouvez sauter.
      • return_tracks
          TYPE : liste de Track
          ACCES : get, observe
          DESCRIPTION :
      • scenes
          TYPE : liste de Scene
          ACCES : get, observe
          DESCRIPTION :
      • tracks
          TYPE : liste de Track
          ACCES : get, observe
          DESCRIPTION :
      • visible_tracks
          TYPE : liste de Track
          ACCES : get, observe
          DESCRIPTION : Une piste est visible si elle ne fait pas partie d’un groupe plié. Si une piste est scrollée hors de vue, elle est toujours considérée comme visible.
      • master_track
          TYPE : Track
          ACCES : get
          DESCRIPTION :
      • view
          TYPE : Song.View
          ACCES : get
          DESCRIPTION :
    • Propriétés
      • appointed_device
          TYPE : Device
          ACCES : get, observe
          DESCRIPTION : Le périphérique « appointed » est celui utilisé par une surface de contrôle, sauf si la surface de contrôle elle-même choisit le périphérique à utiliser. Il est marqué d’une main bleue.
      • arrangement_overdub
          TYPE : bool
          ACCES : get, set, observe
          DESCRIPTION : Récupère / règle l’état du bouton d’Overdub MIDI en Arrangement.
      • back_to_arranger
          TYPE : bool
          ACCES : get, set, observe
          DESCRIPTION : Récupère / règle l’état actuel du bouton Retour à l’arrangement situé dans la barre de transport de Live (1 = en surbrillance). Ce bouton est utilisé pour indiquer que l’état actuel de la lecture diffère de ce qui est stocké dans l’arrangement.
      • can_capture_midi
          TYPE : bool
          ACCES : get, observe
          DESCRIPTION : 1 = Il existe du matériel MIDI récemment joué qui peut être capturé dans une piste en direct. Voir capture_midi.
      • can_jump_to_next_cue
          TYPE : bool
          ACCES : get, observe
          DESCRIPTION : 0 = il n’y a pas de cue point à droite de l’actuel, ou pas du tout.
      • can_jump_to_prev_cue
          TYPE : bool
          ACCES : get, observe
          DESCRIPTION : 0 = il n’y a pas de cue point à gauche de l’actuel, ou pas du tout.
      • can_redo
          TYPE : bool
          ACCES : get
          DESCRIPTION : 1 = il y a quelque chose dans l’historique à refaire.
      • can_undo
          TYPE : bool
          ACCES : get
          DESCRIPTION : 1 = il y a quelque chose dans l’historique à annuler.
      • clip_trigger_quantization
          TYPE : int
          ACCES : get, set, observe
          DESCRIPTION : Reflète le paramètre de quantification dans la barre de transport.
          0 = None
          1 = 8 Mesures
          2 = 4 Mesures
          3 = 2 Mesures
          4 = 1 Mesure
          5 = 1/2
          6 = 1/2T
          7 = 1/4
          8 = 1/4T
          9 = 1/8
          10 = 1/8T
          11 = 1/16
          12 = 1/16T
          13 = 1/32
      • count_in_duration
          TYPE : int
          ACCES : get, observe
          DESCRIPTION : La durée du paramètre de décompte du métronome en tant qu’index, mappée comme suit:
          0 = None
          1 = 1 Mesure
          2 = 2 Mesures
          3 = 4 Mesures
      • current_song_time
          TYPE : float
          ACCES : get, set, observe
          DESCRIPTION : La position de lecture dans le Live Set, en temps.
      • exclusive_arm
          TYPE : bool
          ACCES : get
          DESCRIPTION : État actuel de l’option d’armement exclusif définie dans les préférences Live.
      • exclusive_solo
          TYPE : bool
          ACCES : get
          DESCRIPTION : État actuel de l’option de Solo exclusif définie dans les préférences Live.
      • groove_amount
          TYPE : float
          ACCES : get, set, observe
          DESCRIPTION :La quantité de groove du Groove Pool du Set actuel (0. – 1.0).
      • is_counting_in
          TYPE : bool
          ACCES : get, observe
          DESCRIPTION : 1 = le métronome est en décompte actuellement.
      • is_playing
          TYPE : bool
          ACCES : get, set, observe
          DESCRIPTION : Récupère / règle si le transport de Live est en lecture.
      • last_event_time
          TYPE : float
          ACCES : get
          DESCRIPTION : Temps (en beats) du dernier événement (c.-à-d. Point d’arrêt d’automatisation, fin de Clip, Repère, fin de boucle) dans l’Arrangement
      • loop
          TYPE : bool
          ACCES : get, set, observe
          DESCRIPTION : Récupère / règle l’état activé de la boucle d’Arrangement.
      • loop_length
          TYPE : float
          ACCES : get, set, observe
          DESCRIPTION : Longueur de boucle de l’Arrangement en beats.
      • loop_start
          TYPE : float
          ACCES : get, set, observe
          DESCRIPTION : Position de début de boucle de l’Arrangement en beats.
      • metronome
          TYPE : bool
          ACCES : get, set, observe
          DESCRIPTION : Récupère / règle l’état activé du métronome.
      • midi_recording_quantization
          TYPE : int
          ACCES : get, set, observe
          DESCRIPTION : Récupère / règle la valeur de quantification d’enregistrement actuelle.
          0 = Aucune
          1 = 1/4
          2 = 1/8
          3 = 1/8T
          4 = 1/8 + 1/8T
          5 = 1/16
          6 = 1/16T
          7 = 1/16 + 1/16T
          8 = 1/32
      • nudge_down
          TYPE : bool
          ACCES : get, set, observe
          DESCRIPTION : 1 = le bouton Tempo Nudge Down dans la barre de transport est actuellement enfoncé.
      • nudge_up
          TYPE : bool
          ACCES : get, set, observe
          DESCRIPTION : le bouton Tempo Nudge Up dans la barre de transport est actuellement enfoncé.
      • overdub
          TYPE : bool
          ACCES : get, set, observe
          DESCRIPTION : 1 = MIDI Arrangement Overdub est activé dans la barre de transport.
      • punch_in
          TYPE : bool
          ACCES : get, set, observe
          DESCRIPTION : 1 = le bouton Punch-In est activé dans la barre de transport.
      • punch_out
          TYPE : bool
          ACCES : get, set, observe
          DESCRIPTION : 1 = le bouton Punch-Out est activé dans la barre de transport.
      • re_enable_automation_enabled
          TYPE : bool
          ACCES : get, observe
          DESCRIPTION : 1 = le bouton de réactivation de l’Automation est allumé.
      • record_mode
          TYPE : bool
          ACCES : get, set, observe
          DESCRIPTION : 1 = le bouton d’enregistrement d’Arrangement est allumé.
      • root_note
          TYPE : int
          ACCES : get, set, observe
          DESCRIPTION : La note fondamentale de la chanson utilisée pour les surfaces de contrôle. La note fondamentale peut être un nombre compris entre 0 et 11, où 0 = C et 11 = B.
      • scale_name
          TYPE : unicode
          ACCES : get, set, observe
          DESCRIPTION : Dernier nom de gamme utilisé pour les surfaces de contrôle. Les noms de gamme par défaut qui peuvent être enregistrés avec un Live Set sont:
          ‘Major’
          ‘Minor’
          ‘Dorian’
          ‘Mixolydian’
          ‘Lydian’
          ‘Phrygian’
          ‘Locrian’
          ‘Diminished’
          ‘Whole-half’
          ‘Whole Tone’
          ‘Minor Blues’
          ‘Minor Pentatonic’
          ‘Major Pentatonic’
          ‘Harmonic Minor’
          ‘Melodic Minor’
          ‘Super Locrian’
          ‘Bhairav’
          ‘Hungarian Minor’
          ‘Minor Gypsy’
          ‘Hirojoshi’
          ‘In-Sen’
          ‘Iwato’
          ‘Kumoi’
          ‘Pelog’
          ‘Spanish’
      • scale_intervals
          TYPE : liste
          ACCES : get, observe
          DESCRIPTION : Une liste de nombres entiers représentant les intervalles dans la gamme actuelle, exprimée comme l’intervalle entre le premier degré de la gamme et le degré de la gamme à l’indice de la liste.
      • select_on_launch
          TYPE : bool
          ACCES : get
          DESCRIPTION : 1 = l’option « Sélectionner au lancement » est activée dans les préférences de Live.
      • session_automation_record
          TYPE : bool
          ACCES : get, set, observe
          DESCRIPTION : L’état du bouton d’armement de l’Automation.
      • session_record
          TYPE : bool
          ACCES : get, set, observe
          DESCRIPTION : L’état du bouton d’Overdub de Session.
      • session_record_status
          TYPE : int
          ACCES : get, observe
          DESCRIPTION : L’état du bouton d’enregistrement de Session.
      • signature_denominator
          TYPE : int
          ACCES : get, set, observe
          DESCRIPTION : Le dénominateur de la signature.
      • signature_numerator
          TYPE : int
          ACCES : get, set, observe
          DESCRIPTION : Le numérateur de la signature.
      • song_length
          TYPE : float
          ACCES : get, observe
          DESCRIPTION : Un peu plus que last_event_time, en beats.
      • swing_amount
          TYPE : float
          ACCES : get, set, observe
          DESCRIPTION : Plage: 0,0 – 1,0; affecte la quantification d’enregistrement MIDI et tous les appels directs à Clip.quantize.
      • tempo
          TYPE : float
          ACCES : get, set, observe
          DESCRIPTION : Tempo actuel du Live Set en BPM, 20,0 … 999,0. Le tempo peut être automatisé, il peut donc changer en fonction de la durée actuelle du morceau.
    • Fonctions
      • capture_and_insert_scene
          Capture les clips en cours de lecture et les insére en tant que nouvelle scène sous la scène sélectionnée.
      • capture_midi
          Paramètre : destination [int]
          0 = auto,
          1 = session,
          2 = arrangement Capture du matériel MIDI récemment joué à partir de pistes audibles dans un Clip Live. Si la destination n’est pas définie ou définie sur auto, le clip est inséré dans la vue actuellement visible dans la fenêtre Live qui a le focus. Sinon, il est inséré dans la vue spécifiée.
      • continue_playing
          Depuis la position de lecture actuelle.
      • create_audio_track
          Paramètre : index L’index détermine où la piste est ajoutée, elle n’est valide qu’entre 0 et len(song.tracks). L’utilisation d’un index de -1 ajoutera la nouvelle piste à la fin de la liste.
      • create_midi_track
          Paramètre : index L’index détermine où la piste est ajoutée, elle n’est valide qu’entre 0 et len(song.tracks). L’utilisation d’un index de -1 ajoutera la nouvelle piste à la fin de la liste.
      • create_return_track
          Ajoute une nouvelle piste de retour à la fin.
      • create_scene
          Paramètre : index Renvoie : La nouvelle Scene L’index détermine où la Scene est ajoutée. Il n’est valide qu’entre 0 et len(song.scenes). L’utilisation d’un index de -1 ajoutera la nouvelle Scene à la fin de la liste.
      • delete_scene
          Paramètre : index Supprime la Scene à l’index donné.
      • delete_track
          Paramètre : index
          Supprime la Piste à l’index donné.
      • delete_return_track
          Paramètre : index Supprime la piste de retour à l’index donné.
      • duplicate_scene
          Paramètre : index L’index détermine la Scene à dupliquer.
      • duplicate_track
          Paramètre : index L’index détermine la piste à dupliquer.
      • find_device_position
          Paramètre : device [live object] target [live object] target position [int] Renvoie : [int] La position dans la chaîne de la cible où le périphérique peut être inséré qui est la plus proche possible de la position cible.
      • force_link_beat_time
          Force la timeline de Link à passer au temps de beats actuel de Live.
      • get_beats_loop_length
          Renvoie : bars.beats.sixteenths.ticks [symbol] La longueur de la boucle de l’Arrangement.
      • get_beats_loop_start
          Renvoie : bars.beats.sixteenths.ticks [symbol] La position du début de la boucle de l’Arrangement.
      • get_current_beats_song_time
          Renvoie : bars.beats.sixteenths.ticks [symbol] La position actuelle de lecture de l’arrangement.
      • get_current_smpte_song_time
          Paramètre : format format [int] est le type de timecode à renvoyer
          0 = la position du frame exprime les millisecondes
          1 = Smpte24
          2 = Smpte25
          3 = Smpte30
          4 = Smpte30Drop
          5 = Smpte29
          Renvoie : hours:min:sec:frames [symbol] La position actuelle de lecture de l’arrangement.
      • is_cue_point_selected
          Renvoie : bool 1 = la position actuelle de lecture de l’arrangement est à un repère
      • jump_by
          Paramètre : beats beats [double] est l’intervalle à sauter par rapport à la position actuelle
      • jump_to_next_cue
          Saute au repère à droite, si c’est possible.
      • jump_to_prev_cue
          Saute au repère à gauche, si c’est possible.
      • move_device
          Paramètre : device [live object] target [live object] target position [int]
          Renvoie : [int] La position dans la chaîne de la cible où le périphérique a été inséré. Déplacez le périphérique vers la position spécifiée dans la chaîne cible. Si le périphérique ne peut pas être déplacé vers la position spécifiée, la position la plus proche possible est choisie.
      • play_selection
          Ne fait rien si aucune sélection n’est définie dans Arrangement ou lire la sélection actuelle.
      • re_enable_automation
          Déclenche «Réactiver l’Automation», réactivant l’automatisation dans tous les clips de Session en cours de lecture.
      • redo
          Force l’application Live à refaire la dernière opération.
      • scrub_by
          Paramètre : beats beats [double] la quantité à scrubber par rapport à la position de lecture de l’arrangement actuel. Identique à jump_by, pour le moment.
      • set_or_delete_cue
          Ajoute / supprime le repère à la position actuelle de lecture de l’arrangement.
      • start_playing
          Démarre la lecture à partir du marqueur d’insertion.
      • stop_all_clips
          Paramètre : quantized (optionnel) L’appel de la fonction avec 0 arrêtera immédiatement tous les clips, indépendamment de la quantification de lancement. La valeur par défaut est «1».
      • stop_playing
          Arrête la lecture.
      • tap_tempo
          Identique à la pression du bouton Tap Tempo dans la barre de transport. Le nouveau tempo est calculé en fonction du temps entre les appels suivants de cette fonction.
      • trigger_session_record
          Paramètre : record_length (optionnel) Lance l’enregistrement dans l’emplacement sélectionné ou dans l’emplacement vide suivant, si la piste est armée. Si record_length est fourni, le slot enregistrera pour la longueur donnée en beats. S’il est déclenché pendant l’enregistrement, l’enregistrement s’arrête et la lecture du clip démarre.
      • undo
          Force l’application Live à annuler la dernière opération.
  • Song.View
      Cette classe représente les aspects d’affichage d’un document Live: les vues Session et Arrangement.
      Chemin d’accès : live_set view
    • Enfants
      • detail_clip
          TYPE : Clip
          ACCES : get, set, observe
          DESCRIPTION : Le clip actuellement affiché dans la vue détail de l’application Live.
      • highlighted_clip_slot
          TYPE : ClipSlot
          ACCES : get, set
          DESCRIPTION : Le slot en surbrillance dans la vue de session.
      • selected_chain
          TYPE : Chain
          ACCES : get, set, observe
          DESCRIPTION : La chaine en surbrillance, ou « id 0 » s’il n’y en a pas.
      • selected_parameter
          TYPE : DeviceParameter
          ACCES : get, observe
          DESCRIPTION : Le paramètre sélectionné, ou « id 0 » s’il n’y en a pas.
      • selected_scene
          TYPE : Scene
          ACCES : get, set, observe
          DESCRIPTION : La Scene sélectionnée
      • selected_track
          TYPE : Track
          ACCES : get, set, observe
          DESCRIPTION : La piste sélectionnée
    • Propriétés
      • draw_mode
          TYPE : bool
          ACCES : get, set, observe
          DESCRIPTION :Reflète l’état du commutateur de mode de dessin d’enveloppe / automatisation dans la barre de transport, comme activé avec Cmd / Ctrl-B. 0 = édition de points (montre la flèche), 1 = dessin (montre le crayon)
      • follow_song
          TYPE : bool
          ACCES : get, set, observe
          DESCRIPTION : Reflète l’état du commutateur de suivi de lecture dans la barre de transport comme activé avec Cmd / Ctrl-F. 0 = ne pas suivre la position de lecture, 1 = suivre la position de lecture
    • Fonctions
      • select_device
          Paramètre : id NN Sélectionne le périphérique donné dans sa piste. Vous pouvez obtenir l’id en utilisant un live.path ou en utilisant get devices sur une piste, par exemple. La piste contenant le périphérique ne sera pas affichée automatiquement, et le périphérique obtient le périphérique désigné (main bleue) uniquement si sa piste est sélectionnée.
  • Track
      Cette classe représente une piste de Live. Il peut s’agir d’une piste audio, d’une piste MIDI, d’une piste de retour ou de la piste master. La piste master et au moins une piste audio ou MIDI seront toujours présentes. Les pistes de retour sont facultatives.
      Toutes les propriétés ne sont pas prises en charge par tous les types de pistes. Les propriétés sont marquées en conséquence.
      Chemin d’accès : live_set tracks N
    • Enfants
      • clip_slots
          TYPE : liste de ClipSlot
          ACCES : get, observe
          DESCRIPTION :
      • devices
          TYPE : liste de Device
          ACCES : get, observe
          DESCRIPTION : Inclut le périphérique mixer.
      • group_track
          TYPE : Track
          ACCES : get
          DESCRIPTION : La piste de Groupe, si la piste est groupée. Si ce n’est pas le cas, l’id 0 est renvoyé.
      • mixer_device
          TYPE : MixerDevice
          ACCES : get
          DESCRIPTION :
      • view
          TYPE : Track.View
          ACCES : get
          DESCRIPTION :
    • Propriétés
      • arm
          TYPE : bool
          ACCES : get, set, observe
          DESCRIPTION : 1 = la piste est armée pour l’enregistrement. [pas pour les pistes retour / master]
      • available_input_routing_channels
          TYPE : dictionary
          ACCES : get, observe
          DESCRIPTION : La liste des canaux source disponibles pour le routage d’entrée de la piste. Il est représenté comme un dictionnaire avec la clé suivante: available_input_routing_channels [liste] La liste contient des dictionnaires tels que décrits dans input_routing_channel. Uniquement disponible sur les pistes MIDI et audio.
      • available_input_routing_types
          TYPE : dictionary
          ACCES : get, observe
          DESCRIPTION : La liste des types de source disponibles pour le routage d’entrée de la piste. Il est représenté comme un dictionnaire avec la clé suivante: available_input_routing_types [liste] La liste contient des dictionnaires tels que décrits dans input_routing_type. Uniquement disponible sur les pistes MIDI et audio.
      • available_output_routing_channels
          TYPE : dictionary
          ACCES : get, observe
          DESCRIPTION : La liste des canaux cibles disponibles pour le routage de sortie de la piste. Il est représenté comme un dictionnaire avec la clé suivante: available_output_routing_channels [liste] La liste contient les dictionnaires décrits dans output_routing_channel. Non disponible sur la piste master.
      • available_output_routing_types
          TYPE : dictionary
          ACCES : get, observe
          DESCRIPTION : La liste des types de cibles disponibles pour le routage de sortie de la piste. Il est représenté comme un dictionnaire avec la clé suivante: available_output_routing_types [liste] La liste contient des dictionnaires tels que décrits dans output_routing_type. Non disponible sur la piste master.
      • can_be_armed
          TYPE : bool
          ACCES : get
          DESCRIPTION : 0 pour les pistes de retour et master.
      • can_be_frozen
          TYPE : bool
          ACCES : get
          DESCRIPTION : 1 = la piste peut être gelée, 0 = sinon.
      • can_show_chains
          TYPE : bool
          ACCES : get
          DESCRIPTION : 1 = la piste contient un périphérique Instrument Rack qui peut afficher des chaînes dans la vue Session.
      • color
          TYPE : int
          ACCES : get, set, observe
          DESCRIPTION : La valeur RVB de la couleur de la piste sous la forme 0x00rrggbb ou (2 ^ 16 * rouge) + (2 ^ 8) * vert + bleu, où rouge, vert et bleu sont des valeurs de 0 (foncé) à 255 (clair).
          Lors du réglage de la valeur RVB, la couleur la plus proche du sélecteur de couleur de piste est prise.
      • color_index
          TYPE : long
          ACCES : get, set, observe
          DESCRIPTION : L’indice de couleur de la piste.
      • current_input_routing
          TYPE : symbol
          ACCES : get, set, observe
          DESCRIPTION : Comme tous les autres routages, reflète la chaîne affichée dans le sélecteur de routage.
          Déconseillé depuis Live 9.7. Veuillez utiliser input_routing_type à la place.
      • current_input_sub_routing
          TYPE : symbol
          ACCES : get, set, observe
          DESCRIPTION : N’envoie aucune sortie si le sélecteur ne contient aucune entrée.
          Déconseillé depuis Live 9.7. Veuillez utiliser input_routing_channel à la place.
      • current_monitoring_state
          TYPE : int
          ACCES : get, set, observe
          DESCRIPTION : 0 = In, 1 = Auto, 2 = Off [pas sur pistes retour / master]
      • current_output_routing
          TYPE : symbol
          ACCES : get, set, observe
          DESCRIPTION : Déconseillé depuis Live 9.7. Veuillez utiliser output_routing_type à la place.
      • current_output_sub_routing
          TYPE : symbol
          ACCES : get, set, observe
          DESCRIPTION : N’envoie aucune sortie si le sélecteur ne contient aucune entrée.
          Déconseillé depuis Live 9.7. Veuillez plutôt utiliser output_routing_channel.
      • fired_slot_index
          TYPE : int
          ACCES : get, observe
          DESCRIPTION : Reflète le Slot de Clip clignotant. -1 = aucun Slot déclenché, -2 = bouton d’arrêt de Clip déclenché Le premier Slot de clip a l’index 0. [pas sur pistes retour / master]
      • fold_state
          TYPE : int
          ACCES : get, set
          DESCRIPTION : 0 = les pistes de la piste de Groupe sont visibles, 1 = la piste de Groupe est repliée et les pistes de la piste de Groupe sont masquées [uniquement disponible si is_foldable = 1]
      • has_audio_input
          TYPE : bool
          ACCES : get
          DESCRIPTION : 1 pour les pistes audio.
      • has_audio_output
          TYPE : bool
          ACCES : get
          DESCRIPTION : 1 pour les pistes audio et les pistes MIDI avec instruments.
      • has_midi_input
          TYPE : bool
          ACCES : get
          DESCRIPTION : 1 pour les pistes MIDI.
      • has_midi_output
          TYPE : bool
          ACCES : get
          DESCRIPTION : 1 pour les pistes MIDI sans instrument ni effet audio.
      • implicit_arm
          TYPE : bool
          ACCES : get, set, observe
          DESCRIPTION : Un deuxième état d’armement, uniquement utilisé par Push jusqu’à présent.
      • input_meter_left
          TYPE : float
          ACCES : get, observe
          DESCRIPTION : Valeur de crête momentanée lissée du vumètre d’entrée du canal gauche, 0,0 à 1,0. Pour les pistes avec sortie audio uniquement. Cette valeur correspond aux vumètres affichés en direct. Veuillez prendre en compte que les vumètres audio gauche / droit mettent une charge importante sur la partie GUI de Live.
      • input_meter_level
          TYPE : float
          ACCES : get, observe
          DESCRIPTION : Valeur de crête des vumètres d’entrée des pistes audio et MIDI, 0,0 … 1,0. Pour les pistes audio, c’est le maximum des canaux gauche et droit. Le temps de maintien est de 1 seconde.
      • input_meter_right
          TYPE : float
          ACCES : get, observe
          DESCRIPTION : Valeur de crête momentanée lissée du vumètre d’entrée du canal droit, 0,0 à 1,0. Pour les pistes avec sortie audio uniquement. Cette valeur correspond aux vumètre affichés en direct.
      • input_routing_channel
          TYPE : dictionary
          ACCES : get, set, observe
          DESCRIPTION : Le canal source actuellement sélectionné pour le routage d’entrée de la piste. Il est représenté comme un dictionnaire avec les clés suivantes: display_name [symbole] identifier [symbole] Peut être réglé sur toutes les valeurs trouvées dans les available_input_routing_channels disponibles de la piste. Uniquement disponible sur les pistes MIDI et audio.
      • input_routing_type
          TYPE : dictionary
          ACCES : get, set, observe
          DESCRIPTION : Type de source actuellement sélectionné pour le routage d’entrée de la piste. Il est représenté comme un dictionnaire avec les clés suivantes: display_name [symbole] identifier [symbole] Peut être réglé sur toutes les valeurs trouvées dans les types available_input_routing_types de la piste. Uniquement disponible sur les pistes MIDI et audio.
      • input_routings
          TYPE : liste de symbols
          ACCES : get
          DESCRIPTION : Routages d’entrée disponibles. [pas dans la piste master]
          Déconseillé depuis Live 9.7. Veuillez utiliser available_input_routing_types à la place.
      • input_sub_routings
          TYPE : liste de symbols
          ACCES : get
          DESCRIPTION : Sous-routages disponibles pour le routage d’entrée actuellement sélectionné. Si aucune entrée n’est disponible, rien ne sort. [pas sur la piste master]
          Déconseillé depuis Live 9.7. Veuillez utiliser à la place available_input_routing_channels.
      • is_foldable
          TYPE : bool
          ACCES : get
          DESCRIPTION : 1 = la piste peut être (dé) pliée pour masquer ou révéler les pistes contenues. C’est actuellement le cas pour les pistes de groupe. Les racks d’instruments et de batterie renvoient 0 bien qu’ils puissent être ouverts / fermés. Ce problème sera résolu dans une version ultérieure.
      • is_frozen
          TYPE : bool
          ACCES : get, observe
          DESCRIPTION : 1 = la piste est actuellement gelée.
      • is_grouped
          TYPE : bool
          ACCES : get
          DESCRIPTION : 1 = la piste est contenue dans une piste de Groupe.
      • is_part_of_selection
          TYPE : bool
          ACCES : get
          DESCRIPTION :
      • is_showing_chains
          TYPE : bool
          ACCES : get, set, observe
          DESCRIPTION : Récupère ou définit si une piste avec un périphérique Instrument Rack affiche actuellement ses chaînes dans la vue Session.
      • is_visible
          TYPE : bool
          ACCES : get
          DESCRIPTION : 0 = la piste est cachée dans une piste de Groupe pliée.
      • mute
          TYPE : bool
          ACCES : get, set, observe
          DESCRIPTION : [pas sur la piste master]
      • muted_via_solo
          TYPE : bool
          ACCES : get, observe
          DESCRIPTION :1 = la piste ou la chaîne est mutée car Solo est actif sur au moins une autre piste.
      • name
          TYPE : symbol
          ACCES : get, set, observe
          DESCRIPTION : Comme indiqué dans l’en-tête de piste.
      • output_meter_left
          TYPE : float
          ACCES : get, observe
          DESCRIPTION : Valeur de crête momentanée lissée du vumètre de sortie du canal gauche, 0,0 à 1,0. Pour les pistes avec sortie audio uniquement. Cette valeur correspond aux vumètre affichés en direct. Veuillez noter que les vumètre audio gauche / droit ajoutent une charge significative à l’utilisation des ressources de la GUI de Live.
      • output_meter_level
          TYPE : float
          ACCES : get, observe
          DESCRIPTION : Valeur de crête des indicateurs de sortie des pistes audio et MIDI, de 0,0 à 1,0. Pour les pistes audio, c’est le maximum des canaux gauche et droit. Le temps de maintien est de 1 seconde.
      • output_meter_right
          TYPE : float
          ACCES : get, observe
          DESCRIPTION : Valeur de crête momentanée lissée du vumètre de sortie du canal droit, 0,0 à 1,0. Pour les pistes avec sortie audio uniquement. Cette valeur correspond aux vumètres affichés en direct.
      • output_routing_channel
          TYPE : dictionary
          ACCES : get, set, observe
          DESCRIPTION : Canal cible actuellement sélectionné pour le routage de sortie de la piste. Il est représenté comme un dictionnaire avec les clés suivantes: display_name [symbole] identifier [symbole] Peut être défini sur toutes les valeurs trouvées dans les available_output_routing_channels de la piste. Non disponible sur la piste master.
      • output_routing_type
          TYPE : dictionary
          ACCES : get, set, observe
          DESCRIPTION : Type de cible actuellement sélectionné pour le routage de sortie de la piste. Il est représenté comme un dictionnaire avec les clés suivantes: display_name [symbole] identifier [symbole] Peut être défini sur toutes les valeurs trouvées dans available_output_routing_types de la piste. Non disponible sur la piste master.
      • output_routings
          TYPE : liste de symbols
          ACCES : get
          DESCRIPTION : Routages de sortie disponibles. [pas sur la piste master]
          Déconseillé depuis Live 9.7. Veuillez utiliser à la place available_output_routing_types.
      • output_sub_routings
          TYPE : liste de symbols
          ACCES : get
          DESCRIPTION : Sous-routages disponibles pour le routage de sortie actuellement sélectionné. Si aucune entrée n’est disponible, rien n’est sorti. [pas sur la piste master]
          Déconseillé depuis Live 9.7. Veuillez utiliser à la place available_output_routing_channels.
      • playing_slot_index
          TYPE : int
          ACCES : get, observe
          DESCRIPTION : Le premier slot a l’index 0. -2 = Bonton stop de Slot de clip déclenché dans la vue de session, -1 = enregistrement dans l’Arrangement sans lecture de clip de Session. [pas sur les pistes retour / master]
      • solo
          TYPE : bool
          ACCES : get, set, observe
          DESCRIPTION : Remarque: lors de la définition de cette propriété, la logique exclusive du Solo est contournée, vous devez donc annuler le son des autres pistes vous-même. [pas sur la piste master]
    • Fonctions
      • delete_clip
          Paramètre : clip Supprime le Clip donné.
      • delete_device
          Paramètre : index Supprime le périphérique à l’index donné.
      • duplicate_clip_slot
          Paramètre : index Fonctionne comme «Dupliquer» dans le menu contextuel d’un clip.
      • duplicate_clip_to_arrangement
          Paramètres : clip destination_time [double] Duplique le clip donné dans l’Arrangement, en le plaçant à la destination_time donnée en beat.
      • jump_in_running_session_clip
          Paramètre : beats beats [double] est la quantité à sauter par rapport à la position actuelle du clip. Modifie la position de lecture dans le clip de Session en cours, le cas échéant.
      • stop_all_clips
          Arrête tous les clips lus et déclenchés dans cette piste.
  • Track.View
      Représente les aspects d’affichage d’une piste.
      Chemin d’accès : live_set tracks N view
    • Enfants
      • selected_device
          TYPE : Device
          ACCES : get, observe
          DESCRIPTION : Le périphérique sélectionné ou le premier périphérique sélectionné (en cas de sélection multi / groupe).
    • Propriétés
      • device_insert_mode
          TYPE : int
          ACCES : get, set, observe
          DESCRIPTION : Détermine où un périphérique sera inséré lors du chargement à partir du navigateur. 0 = ajouter un périphérique à la fin, 1 = ajouter un périphérique à gauche du périphérique sélectionné, 2 = ajouter un périphérique à droite du périphérique sélectionné.
      • is_collapsed
          TYPE : bool
          ACCES : get, set, observe
          DESCRIPTION : Dans la vue Arrangement: 1 = piste repliée, 0 = piste ouverte.
    • Fonctions
      • select_instrument
          Renvoie : bool 0 = il n’y a pas de périphérique à sélectionner
          Sélectionne l’instrument ou le premier périphérique de la piste, le rend visible et se concentre dessus.
  • ClipSlot
      Cette classe représente une entrée dans la matrice d’affichage de Session de Live.
      Les propriétés playing_status, is_playing et is_recording sont utiles pour les slots de clip des pistes de Groupe. Ils sont toujours vides et représentent l’état des clips dans les pistes à l’intérieur de la piste de Groupe.
      Chemin d’accès : live_set tracks N clip_slots M
    • Enfants
      • clip
          TYPE : Clip
          ACCES : get
          DESCRIPTION : id 0 si le slot est vide
    • Propriétés
      • color
          TYPE : long
          ACCES : get, observe
          DESCRIPTION : Couleur du premier clip de la piste de groupe si le slot de clip est un slot de piste de groupe.
      • color_index
          TYPE : long
          ACCES : get, observe
          DESCRIPTION : Indice de couleur du premier clip de la piste de groupe si le slot de clip est un slot de piste de groupe.
      • controls_other_clips
          TYPE : bool
          ACCES : get, observe
          DESCRIPTION : 1 pour un slot de piste de groupe qui a des clips non désactivés dans les pistes de son groupe.
          Le contrôle des slot de clip vides ne compte pas.
      • has_clip
          TYPE : bool
          ACCES : get, observe
          DESCRIPTION : 1 = un clip existe dans ce slot de clip.
      • has_stop_button
          TYPE : bool
          ACCES : get, set, observe
          DESCRIPTION : 1 = ce clip arrête sa piste (ou les pistes d’une piste de groupe).
      • is_group_slot
          TYPE : bool
          ACCES : get
          DESCRIPTION : 1 = ce slot de clip est un slot de piste de groupe.
      • is_playing
          TYPE : bool
          ACCES : get
          DESCRIPTION : 1 = playing_status != 0, sinon 0.
      • is_recording
          TYPE : bool
          ACCES : get
          DESCRIPTION : 1 = playing_status == 2, sinon 0.
      • is_triggered
          TYPE : bool
          ACCES : get, observe
          DESCRIPTION : 1 = le bouton du clip (lancement, arrêt ou enregistrement du clip) ou le bouton du clip contenu (Piste de Groupe) clignote.
      • playing_status
          TYPE : int
          ACCES : get, observe
          DESCRIPTION : 0 = tous les clips des pistes d’une piste de groupe sont arrêtés ou toutes les pistes d’une piste de groupe sont vides.
          1 = au moins un clip d’une piste d’une piste de groupe est en cours de lecture.
          2 = au moins un clip d’une piste d’une piste de groupe est en cours de lecture ou d’enregistrement.
          Égal à 0 s’il ne s’agit pas d’un slot de clip d’une piste de groupe.
      • will_record_on_start
          TYPE : bool
          ACCES : get
          DESCRIPTION : 1 = le slot de clip enregistrera au démarrage.
    • Fonctions
      • create_clip
          Paramètre : length
          Length est donné en beats et doit être supérieur à 0,0. Ne peut être appelé que sur des slots de clip vides dans des pistes MIDI.
      • delete_clip
          Supprime le clip contenu.
      • duplicate_clip_to
          Paramètre : target_clip_slot [ClipSlot]Duplique le clip du slot au slot de clip donné, remplaçant le clip du slot de clip cible s’il n’est pas vide.
      • fire
          Paramètre : record_length (optional)
          launch_quantization (optional)
          Déclenche le clip ou déclenche le bouton d’arrêt, le cas échéant. Démarre l’enregistrement si le slot est vide et que la piste est armée. Démarre l’enregistrement des pistes armées et vides dans une piste de groupe si Préférences -> Launch-> Démarrer l’enregistrement au lancement de la scène est activé. Si record_length est fourni, le slot enregistrera pour la longueur donnée en beats. launch_quantization remplace la quantification globale si elle est fournie.
      • set_fire_button_state
          Paramètre : state [bool]1 = Live simule le fait d’appuyer sur le bouton Clip Launch jusqu’à ce que l’état soit réglé sur 0 ou jusqu’à ce que le slot soit arrêté autrement.
      • stop
          Arrête la lecture ou l’enregistrement des clips de cette piste ou des pistes du groupe, le cas échéant. Peu importe sur quel slot de la piste vous appelez cette fonction.
  • Clip
      Cette classe représente un clip dans Live. Il peut s’agir d’un clip audio ou d’un clip MIDI dans la vue Arrangement ou Session, selon la piste / l’emplacement dans lequel il se trouve.
      Chemin d’accès : live_set tracks N clip_slots M clip
    • Enfants
      • view
          TYPE : Clip.View
          ACCES : get
          DESCRIPTION :
    • Propriétés
      • available_warp_modes
          TYPE : liste
          ACCES : get
          DESCRIPTION : Renvoie la liste des index des modes Warp disponibles pour le clip. Valable uniquement pour les clips audio.
      • color
          TYPE : int
          ACCES : get, set, observe
          DESCRIPTION : La valeur RVB de la couleur du clip sous la forme 0x00rrggbb ou (2 ^ 16 * rouge) + (2 ^ 8) * vert + bleu, où rouge, vert et bleu sont des valeurs de 0 (sombre) à 255 (clair).
          Lors de la définition de la valeur RVB, la couleur la plus proche du sélecteur de couleur de clip est prise.
      • color_index
          TYPE : int
          ACCES : get, set, observe
          DESCRIPTION : L’indice de couleur de clip.
      • end_marker
          TYPE : double
          ACCES : get, set, observe
          DESCRIPTION : Marqueur de fin du clip en beats, indépendamment de l’état de la boucle. Ne peut pas être défini avant le marqueur de départ.
      • end_time
          TYPE : double
          ACCES : get, observe
          DESCRIPTION : Le temps de fin du clip. Pour les clips de vue de session, si la boucle est activée, il s’agit de la fin de la boucle, sinon c’est le marqueur de fin. Pour les clips de la vue Arrangement, il s’agit toujours de la position du bord le plus à droite du clip dans l’arrangement.
      • gain
          TYPE : double
          ACCES : get, set, observe
          DESCRIPTION : Gain du clip (plage de 0,0 à 1,0). Valable uniquement pour les clips audio.
      • gain_display_string
          TYPE : symbol
          ACCES : get
          DESCRIPTION : Récupère la valeur d’affichage du gain du clip sous forme de chaîne (par exemple, « 1.3 dB »). Ne peut être appelé que sur des clips audio.
      • file_path
          TYPE : symbol
          ACCES : get
          DESCRIPTION : Récupère l’emplacement du fichier audio représenté par le clip. Uniquement disponible pour les clips audio.
      • has_envelopes
          TYPE : bool
          ACCES : get, observe
          DESCRIPTION : Récupère / observe si le clip a une automatisation.
      • is_arrangement_clip
          TYPE : bool
          ACCES : get
          DESCRIPTION : 1 = Le clip est un clip d’arrangement.
          Un clip peut être un clip d’Arrangement ou un clip de Session.
      • is_audio_clip
          TYPE : bool
          ACCES : get
          DESCRIPTION : 0 = clip MIDI, 1 = clip audio
      • is_midi_clip
          TYPE : bool
          ACCES : get
          DESCRIPTION : L’opposé de is_audio_clip .
      • is_overdubbing
          TYPE : bool
          ACCES : get, observe
          DESCRIPTION : 1 = le clip est en overdub.
      • is_playing
          TYPE : bool
          ACCES : get, set
          DESCRIPTION : 1 = le clip est en lecture ou en enregistrement.
      • is_recording
          TYPE : bool
          ACCES : get, observe
          DESCRIPTION : 1 = le clip est en enregistrement.
      • is_triggered
          TYPE : bool
          ACCES : get
          DESCRIPTION : 1 = le bouton de lancement de Clip clignote.
      • length
          TYPE : double
          ACCES : get
          DESCRIPTION : Pour les clips en boucle: longueur de boucle en beats. Sinon, c’est la distance en beats du marqueur de début à la fin. N’a aucun sens pour les clips audio non warpés.
      • loop_end
          TYPE : double
          ACCES : get, set, observe
          DESCRIPTION : Pour les clips en boucle: fin de boucle.
          Pour les clips sans boucle: fin du clip.
      • loop_jump
          TYPE : bang
          ACCES : observe
          DESCRIPTION : Envoie un bang lorsque la position de lecture du clip passe par le marqueur de début de boucle (éventuellement projeté dans la boucle).
      • loop_start
          TYPE : double
          ACCES : get, set, observe
          DESCRIPTION : Pour les clips en boucle: début de la boucle.
          Pour les clips sans boucle: début du clip.
          loop_start et loop_end sont en beat de clip absolu si le clip est MIDI ou warpé. La position 1.1.1 a un temps de battement de 0. Si le clip est audio non warpé, ils sont donnés en secondes, 0 est le temps du premier échantillon dans le matériel audio.
      • looping
          TYPE : bool
          ACCES : get, set, observe
          DESCRIPTION : 1 = le clip est en boucle. L’audio non warpé ne peut pas être mis en boucle.
      • muted
          TYPE : bool
          ACCES : get, set, observe
          DESCRIPTION : 1 = muet (c’est-à-dire que le bouton d’activation de clip du clip est désactivé).
      • name
          TYPE : symbol
          ACCES : get, set, observe
          DESCRIPTION :
      • notes
          TYPE : bang
          ACCES : observe
          DESCRIPTION : L’observer envoie un bang lorsque la liste de notes change.
          Disponible uniquement pour les clips MIDI.
      • pitch_coarse
          TYPE : int
          ACCES : get, set, observe
          DESCRIPTION : Changement de hauteur (pitch) en demi-tons (« Transpose »), -48 … 48.
          Disponible uniquement pour les clips audio.
      • pitch_fine
          TYPE : float
          ACCES : get, set, observe
          DESCRIPTION : Changement de hauteur supplémentaire en cents (« Detune »), -50 … 49.
          Disponible uniquement pour les clips audio.
      • playing_position
          TYPE : float
          ACCES : get, observe
          DESCRIPTION : Position de lecture actuelle du clip.
          Pour les clips audio MIDI et warpés, la valeur est donnée en beats de clip absolu. Le beat 0 du clip est l’endroit où 1.1 est affiché dans la barre mesure / beat / doucle-croche  en haut de la vue du clip.
          Pour les clips audio non warpés, la position est donnée en secondes, selon l’échelle de temps indiquée au bas de la vue du clip.
          Les clips arrêtés ont une position de lecture de 0.
      • playing_status
          TYPE : bang
          ACCES : observe
          DESCRIPTION : L’observer envoie un bang lors de la modification de l’état de lecture / déclenchement.
      • position
          TYPE : float
          ACCES : get, observe
          DESCRIPTION : Récupère et règle la position de boucle du clip. La valeur sera toujours égale à loop_start, mais le réglage de cette propriété, contrairement au réglage de loop_start, préserve la longueur de la boucle.
      • ram_mode
          TYPE : bool
          ACCES : get, set, observe
          DESCRIPTION : 1 = le commutateur RAM d’un clip audio est activé.
      • signature_denominator
          TYPE : int
          ACCES : get, set, observe
          DESCRIPTION :
      • signature_numerator
          TYPE : int
          ACCES : get, set, observe
          DESCRIPTION :
      • start_marker
          TYPE : double
          ACCES : get, set, observe
          DESCRIPTION : Marqueur de début du clip en beats, indépendamment de l’état de la boucle. Ne peut pas être placé derrière le marqueur de fin.
      • start_time
          TYPE : double
          ACCES : get
          DESCRIPTION : Le moment auquel le clip a démarré, par rapport au temps global du morceau. La valeur est en beats.
      • warp_mode
          TYPE : int
          ACCES : get, set, observe
          DESCRIPTION :
          Le mode Warp du clip sous forme d’index entier. Les modes de warp disponibles sont:
          0 = Beats Mode
          1 = Tones Mode
          2 = Texture Mode
          3 = Re-Pitch Mode
          4 = Complex Mode
          5 = REX Mode
          6 = Complex Pro Mode
          Disponible uniquement pour les clips audio.
      • warping
          TYPE : bool
          ACCES : get, set, observe
          DESCRIPTION : 1 = le bouton Warp est activé.
          Disponible uniquement pour les clips audio.
      • will_record_on_start
          TYPE : bool
          ACCES : get
          DESCRIPTION : 1 pour les clips MIDI qui sont lancés, avec la piste armée et le bouton Overdub Arrangement MIDI activé.
    • Fonctions
      • clear_all_envelopes
          Supprime toute automation du clip.
      • clear_envelope
          Paramètre : device_parameter [id]Supprime l’automation du clip pour le paramètre donné.
      • crop
          Rogne le clip: si le clip est bouclé, la région en dehors de la boucle est supprimée; si ce n’est pas le cas, la région en dehors des marqueurs de début et de fin.
      • deselect_all_notes
          Appeler cette fonction avant replace_selected_notes si vous voulez simplement ajouter quelques notes.
          Renvoie:
          deselect_all_notes id 0
          Pour les clips MIDI uniquement.
      • duplicate_loop
          Rend la boucle deux fois plus longue en déplaçant loop_end vers la droite et duplique les notes et les enveloppes. Si le clip n’est pas bouclé, la plage de début / fin du clip est dupliquée. Disponible uniquement pour les clips MIDI.
      • duplicate_region
          Paramètres :
          region_start [double/int]region_length [double/int]destination_time [double/int]pitch (optionel) [int]transposition_amount (optionel) [int]Duplique les notes de la région spécifiée à destination_time. Seules les notes de la hauteur spécifiée sont dupliquées ou toutes si la hauteur est -1. Si transposition_amount n’est pas 0, les notes de la région seront transposées par transpose_amount demi-tons. Disponible uniquement pour les clips MIDI.
      • fire
          Même effet que d’appuyer sur le bouton de lancement de Clip.
      • get_notes
          Paramètres :
          from_time [double/int]from_pitch [int]time_span [double/int]pitch_span [int]Renvoie une liste de notes qui commencent dans la zone donnée. La sortie est similaire à get_selected_notes.
      • get_selected_notes
          Utilisez-le si vous souhaitez opérer sur les notes sélectionnées.
          Renvoie:
          get_selected_notes notes count
          get_selected_notes note pitch time duration velocity muted

          get_selected_notes done
          count [int] est le nombre de lignes de note à suivre.
          pitch [int] est le numéro de note MIDI, 0 … 127, 60 est C3.
          time [double] est le temps de début de la note en beats absolu du clip.
          duration [double] est la longueur de la note en beats.
          velocity [int] est la vélocité de la note, 1 … 127.
          muet [bool] 1 = la note est désactivée.
          Pour les clips MIDI uniquement.
      • move_playing_pos
          Paramètre : beats
          beats [double] distance relative de saut en beats. Les beats négatifs sautent en arrière.
          Saute d’un montant donné, non quantifié.
          Les clips audio non warpés, l’enregistrement de clips audio et l’enregistrement de clips MIDI sans superposition ne peuvent pas sauter.
      • quantize
          Paramètre :
          quantization_grid [int]amount [double]Quantifie toutes les notes du clip dans la quantification_grid en tenant compte du swing_amount du morceau.
      • quantize_pitch
          Paramètres :
          pitch [int]quantization_grid [int]amount [double]Identique à quantize, mais uniquement pour les notes à la hauteur donnée.
      • remove_notes
          Paramètres :
          from_time [double]from_pitch [int]time_span [double]pitch_span [int]Supprime toutes les notes qui commencent dans la zone donnée.
      • replace_selected_notes

          Pour remplacer les notes sélectionnées dans le clip, envoyez une série d’appels de fonction suivants au clip.
          replace_selected_notes
          notes count
          note pitch time duration velocity muted
          done
          La séquence est la même que dans get_selected_notes, les paramètres sont également les mêmes. La séquence doit toujours être terminée, car le clip attend les appels respectifs même si des messages intermédiaires sont envoyés. Si count est nul, cela signifie qu’il n’y a aucun appel de note.
          Dans Live, les notes ne se chevauchent pas. Par conséquent, si les nouvelles notes se chevauchent avec des notes non sélectionnées, les notes non sélectionnées sont conçues pour s’ajuster de la même manière que lorsque vous modifiez des notes manuellement.
          Un exemple de séquence d’appels ressemble à ceci:
          call replace_selected_notes
          call notes 2
          call note 60 0.0 0.5 100 0
          call note 62 0.5 0.5 64 0
          call done
          Pour les clips MIDI uniquement.
      • scrub
          Paramètre : beat_time [double]
          Faites défiler le clip à une durée spécifiée en temps. Cela se comporte exactement comme scrubber avec la souris; le scrub respectera la Quantification Globale, démarrant et bouclant synchro avec le transport. Le scrub continuera jusqu’à ce que stop_scrub () soit appelé.
      • select_all_notes
          Utilisez cette fonction pour traiter toutes les notes d’un clip, indépendamment de la sélection actuelle.
          Renvoie:
          select_all_notes id 0
          Pour les clips MIDI uniquement.
      • set_fire_button_state
          Paramètre : state [bool]Si l’état est défini sur 1, Live simule une pression sur le bouton de démarrage du clip jusqu’à ce que l’état soit défini sur 0 ou jusqu’à ce que le clip soit arrêté autrement.
      • set_notes
          Paramètre :
          liste_of_notes [pitch, time, duration, velocity, is_muted]Appliquera les notes données au clip, écrasant les notes existantes.
          Un exemple de séquence d’appels ressemble à ceci: 
          call set_notes
          call notes 2
          call note 60 0.0 0.5 100 0
          call note 62 0.5 0.5 64 0
          call done
          Seulement pour les clips MIDI.
      • stop
          Même effet que d’appuyer sur le bouton d’arrêt de la piste, mais uniquement si ce clip est en cours de lecture ou d’enregistrement. Si ce clip est lancé ou si un autre clip de cette piste est en cours de lecture, il n’a aucun effet.
      • stop_scrub
          Stoppe un scrub actif sur un clip.
  • Clip.View
      Représente les aspects d’affichage d’un clip.
      Chemin d’accès : live_set tracks N clip_slots M clip view
    • Propriétés
      • grid_is_triplet
          TYPE : bool
          ACCES : get, set
          DESCRIPTION : Récupère / règle si le clip est affiché avec une grille de triolets.
      • grid_quantization
          TYPE : int
          ACCES : get, set
          DESCRIPTION : Récupère / règle la quantification de la grille.
    • Fonctions
      • hide_envelope
          Cache le panneau d’Enveloppes.
      • select_envelope_parameter
          Paramètre : [DeviceParameter]Sélectionne le paramètre de périphérique spécifié dans le panneau Enveloppes.
      • show_envelope
          Affiche le panneau Envelopes.
      • show_loop
          Si le clip est visible dans la vue détail de Live, cette fonction affichera la boucle actuelle.
  • Scene
      Cette classe représente une série de slots de clip dans la matrice d’affichage de Session de Live.
      Chemin d’accès: live_set scenes N
    • Enfants
      • clip_slots
          TYPE : liste de ClipSlot
          ACCES : get, observe
          DESCRIPTION : Liste des ClipSlots de la scène.
    • Propriétés
      • color
          TYPE : int
          ACCES : get, set, observe
          DESCRIPTION : La valeur RVB de la couleur de la scène sous la forme 0x00rrggbb ou (2 ^ 16 * rouge) + (2 ^ 8) * vert + bleu, où rouge, vert et bleu sont des valeurs de 0 (foncé) à 255 (clair). en définissant la valeur RVB, la couleur la plus proche du sélecteur de couleur de scène est prise.
      • color_index
          TYPE : long
          ACCES : get, set, observe
          DESCRIPTION : L’indice de couleur de la scene.
      • is_empty
          TYPE : bool
          ACCES : get
          DESCRIPTION : 1 = aucun des emplacements de la scène n’est occupé.
      • is_triggered
          TYPE : bool
          ACCES : get, observe
          DESCRIPTION : 1 = la scène clignote.
      • name
          TYPE : symbol
          ACCES : get, set, observe
          DESCRIPTION : Peut contenir du BPM et des commandes de signature (comme « 128 BPM 3/4 »).
      • tempo
          TYPE : float
          ACCES : get, set
          DESCRIPTION : Tempo dans BPM tel que trouvé par Live dans le nom.
    • Fonctions
      • fire
          Paramètre : force_legato (optional) [bool]can_select_scene_on_launch (optional) [bool]
          Déclenche tous les emplacements de clip contenus dans la scène et sélectionne cette scène.
          Démarre l’enregistrement des pistes armées et vides dans une piste de groupe dans cette scène si Préférences-> Lancer-> Démarrer l’enregistrement au lancement de la scène est activé.
          L’appel avec force_legato = 1 (par défaut = 0) lancera tous les clips immédiatement dans Legato, indépendamment de leur mode de lancement.
      • fire_as_selected
          Paramètre : force_legato (optional) [bool]Déclenche la scène sélectionnée, puis sélectionne la scène suivante.
          Peu importe sur quelle scène vous appelez cette fonction.
          Appeler avec force_legato = 1 (par défaut = 0) lancera tous les clips immédiatement dans Legato, indépendamment de leur mode de lancement. 
      • set_fire_button_state
          Paramètre : state [bool]Si l’état est défini sur 1, Live simule une pression sur le bouton de scène jusqu’à ce que l’état soit défini sur 0 ou jusqu’à ce que la scène s’arrête dans le cas contraire.
  • Device
      Cette classe représente un périphérique MIDI ou audio dans Live.
      Chemin d’accès : live_set tracks N devices M
      Chemin d’accès : live_set tracks N devices M chains L devices K
      Chemin d’accès : live_set tracks N devices M return_chains L devices K
    • Enfants
      • parameters
          TYPE : liste de DeviceParameter
          ACCES : get, observe
          DESCRIPTION : Seuls les paramètres automatisables sont accessibles. Voir DeviceParameter pour savoir comment les modifier.
      • view
          TYPE : Device.View
          ACCES : get
          DESCRIPTION :
    • Propriétés
      • can_have_chains
          TYPE : bool
          ACCES : get
          DESCRIPTION : 0 pour un seul périphérique
          1 pour un rack
      • can_have_drum_pads
          TYPE : bool
          ACCES : get
          DESCRIPTION : 1 pour les Drum Racks
      • class_display_name
          TYPE : symbol
          ACCES : get
          DESCRIPTION : Permet de récupèrer le nom d’origine du périphérique (par exemple Operator, Auto Filter).
      • class_name
          TYPE : symbol
          ACCES : get
          DESCRIPTION : Type de périphériquede Live: tel que MidiChord, Operator, Limiter, MxDeviceAudioEffect ou PluginDevice.
      • is_active
          TYPE : bool
          ACCES : get, observe
          DESCRIPTION : 0 = le périphérique lui-même ou son Rack est éteint.
      • name
          TYPE : symbol
          ACCES : get, set, observe
          DESCRIPTION : Il s’agit du nom affiché dans la barre de titre du périphérique.
      • type
          TYPE : symbol
          ACCES : get
          DESCRIPTION : Le type de périphérique. Les types possibles sont: 0 = non défini, 1 = instrument, 2 = audio_effect, 3 = midi_effect.
    • Fonctions
      • store_chosen_bank
          Paramètres:
          script_index [int]bank_index [int](Ceci est lié aux surfaces de contrôle et n’est généralement pas pertinent.)
  • Device.View
      Représente les aspects d’affichage d’un périphérique.
      Chemin d’accès : live_set tracks N devices M view
      Chemin d’accès : live_set tracks N devices M chains L devices K view
      Chemin d’accès : live_set tracks N devices M return_chains L devices K view
    • Propriétés
      • is_collapsed
          TYPE : bool
          ACCES : get, set, observe
          DESCRIPTION : 1 = le périphérique est affiché replié dans la chaîne de périphériques.
  • DeviceParameter
      Cette classe représente un paramètre (automatisable) dans un périphérique MIDI ou audio. Pour modifier un paramètre de périphérique, définissez sa propriété value ou envoyez son ID d’objet à live.remote ~.
      Chemin d’accès : live_set tracks N devices M parameters L
    • Propriétés
      • automation_state
          TYPE : int
          ACCES : get, observe
          DESCRIPTION : Permet d’obtenir l’état d’automation du paramètre.
          0 = pas d’automation.
          1 = automation active.
          2 = automation remplacée.
      • default_value
          TYPE : float
          ACCES : get
          DESCRIPTION : Permet d’obtenir la valeur par défaut de ce paramètre.
          Uniquement disponible pour les paramètres non quantifiés (voir is_quantized).
      • is_enabled
          TYPE : bool
          ACCES : get
          DESCRIPTION : 1 = la valeur du paramètre peut être modifiée directement par l’utilisateur, en envoyant le set à un live.object, par automatisation ou par un message MIDI assigné ou par une frappe.
          Les paramètres peuvent être désactivés si ils sont macro-contrôlés, ou s’ils sont contrôlés par un objet live-remote ~, ou parce que Live pense qu’ils ne doivent pas être changés.
      • is_quantized
          TYPE : bool
          ACCES : get
          DESCRIPTION : 1 pour les booléens et les énumérations
          0 pour les paramètres int / float
          Bien que des paramètres tels que MidiPitch.Pitch semblent quantifiés pour l’utilisateur, ils ont en fait une valeur is_quantized de 0.
      • max
          TYPE : float
          ACCES : get
          DESCRIPTION : Valeur maximale autorisée.
      • min
          TYPE : float
          ACCES : get
          DESCRIPTION : Valeur minimale autorisée.
      • name
          TYPE : symbol
          ACCES : get
          DESCRIPTION : Nom de paramètre court, comme indiqué dans le sélecteur d’automation (fermé).
      • original_name
          TYPE : symbol
          ACCES : get
          DESCRIPTION : Nom d’un paramètre de Macro avant son affectation.
      • state
          TYPE : int
          ACCES : get, observe
          DESCRIPTION : L’état actif du paramètre.
          0 = le paramètre est actif et peut être modifié.
          1 = le paramètre peut être modifié mais n’est pas actif, donc les changements n’auront pas d’effet audible.
          2 = le paramètre ne peut pas être modifié.
      • value
          TYPE : float
          ACCES : get, set, observe
          DESCRIPTION : Valeur linéaire vers GUI entre min et max.
      • value_items
          TYPE : StringVector
          ACCES : get
          DESCRIPTION : Permet d’obtenir une liste des valeurs possibles pour ce paramètre.
          Disponible uniquement pour les paramètres quantifiés (voir is_quantized).
    • Fonctions
      • re_enable_automation
          Réactive l’automation pour ce paramètre.
      • str_for_value
          Paramètre : value [float] Renvoie : [symbol] Représentation sous forme de chaîne de caractères de la valeur spécifiée.
      • __str__
          Renvoie : [symbol] Représentation sous forme de chaîne de caractères de la valeur du paramètre.
  • RackDevice
      Cette classe représente un rack de périphériques de Live.
      Un RackDevice est un type de Device, ce qui signifie qu’il a tous les Enfants, Propriétés et Fonctions qu’un Device a. Ci-dessous sont des membres uniques à RackDevice. 
    • Enfants
      • chains
          TYPE : liste de Chain
          ACCES : get, observe
          DESCRIPTION : Les chaines du Rack.
      • drum_pads
          TYPE : liste de DrumPad
          ACCES : get, observe
          DESCRIPTION : Les 128 pads de batterie pour le Drum Rack le plus haut. Les Drum Racks imbriqués renvoient une liste de 0 entrées.
      • return_chains
          TYPE : liste de Chain
          ACCES : get, observe
          DESCRIPTION : Les chaines de Retour du Rack.
      • visible_drum_pads
          TYPE : liste de DrumPad
          ACCES : get, observe
          DESCRIPTION : Les 16 DrumPads visibles pour le Drum Rack le plus haut. Les Drum Racks imbriqués renvoient une liste de 0 entrées.
    • Propriétés
      • can_show_chains
          TYPE : bool
          ACCES : get
          DESCRIPTION : 1 = Le rack contient un périphérique instrument capable d’afficher ses chaînes dans la vue Session.
      • has_drum_pads
          TYPE : bool
          ACCES : get, observe
          DESCRIPTION : 1 = l’appareil est un Drum Rack avec des pads. Un Drum Rack imbriqué est un Drum Rack sans pads.
          Uniquement disponible pour les Drum Racks.
      • has_macro_mappings
          TYPE : bool
          ACCES : get, observe
          DESCRIPTION : 1 = l’une des macros d’un rack est mappée à un paramètre.
      • is_showing_chains
          TYPE : bool
          ACCES : get, set, observe
          DESCRIPTION : 1 = Le rack contient un instrument qui affiche ses chaînes dans la vue de session.
    • Fonctions
      • copy_pad
          Paramètres:
          source_index [int]destination_index [int]Copie tout le contenu d’un pad de Drum Rack d’un pad source vers un pad de destination. Les index source_index et destination_index font référence aux index des pads à l’intérieur d’un rack de batterie.
  • RackDevice.View
      Représente les aspects d’affichage d’un périphérique de type rack. Un RackDevice.View est un type de Device.View, ce qui signifie qu’il a toutes les propriétés d’un Device.View. Ci-dessous sont les membres uniques à RackDevice.View.
    • Enfants
      • selected_drum_pad
          TYPE : DrumPad
          ACCES : get, set, observe
          DESCRIPTION : Pad de rack de batterie actuellement sélectionné.
          Uniquement disponible pour les racks de batterie.
      • selected_chain
          TYPE : Chain
          ACCES : get, set, observe
          DESCRIPTION : Chaine actuellement sélectionnée.
      • Propriétés
        • drum_pads_scroll_position
            TYPE : int
            ACCES : get, set, observe
            DESCRIPTION : Rangée de pads la plus basse  visible, plage: 0 – 28.
            Uniquement disponible pour les racks de batterie.
        • is_showing_chain_devices
            TYPE : bool
            ACCES : get, set, observe
            DESCRIPTION : 1 = les périphériques de la chaîne actuellement sélectionnée sont visibles. 
  • DrumPad
      Cette classe représente un pad Drum Rack dans Live.
      Chemin d’accès : live_set tracks N devices M drum_pads L
    • Enfants
      • chains
          TYPE : Chain
          ACCES : get, observe
          DESCRIPTION :
    • Propriétés
      • mute
          TYPE : bool
          ACCES : get, set, observe
          DESCRIPTION : 1 = mute activé
      • name
          TYPE : symbol
          ACCES : get, observe
          DESCRIPTION :
      • note
          TYPE : int
          ACCES : get
          DESCRIPTION :
      • solo
          TYPE : bool
          ACCES : get, set, observe
          DESCRIPTION : 1 = solo activé
          Ne désactive pas automatiquement Solo dans les autres chaînes.
    • Fonctions
  • Chain
      Cette classe représente une chaine de périphérique de type Rack dans Live.
      Chemin d’accès : live_set tracks N devices M chains L
      Chemin d’accès : live_set tracks N devices M return_chains L
      Chemin d’accès : live_set tracks N devices M chains L devices K chains P …
      Chemin d’accès : live_set tracks N devices M return_chains L devices K chains P …
    • Enfants
      • devices
          TYPE : Device
          ACCES : get, observe
          DESCRIPTION :
      • mixer_device
          TYPE : ChainMixerDevice
          ACCES : get
          DESCRIPTION :
    • Propriétés
      • color
          TYPE : int
          ACCES : get, set, observe
          DESCRIPTION : La valeur RVB de la couleur de la chaîne sous la forme 0x00rrggbb ou (2 ^ 16 * rouge) + (2 ^ 8) * vert + bleu, où rouge, vert et bleu sont des valeurs de 0 (foncé) à 255 (clair). En définissant la valeur RVB, la couleur la plus proche du sélecteur de couleurs est prise.
      • color_index
          TYPE : long
          ACCES : get, set, observe
          DESCRIPTION : L’indice de couleur de la chaine.
      • is_auto_colored
          TYPE : bool
          ACCES : get, set, observe
          DESCRIPTION :
          1 = la chaîne aura toujours la couleur de la piste ou de la chaîne contenante.
      • has_audio_input
          TYPE : bool
          ACCES : get
          DESCRIPTION :
      • has_audio_output
          TYPE : bool
          ACCES : get
          DESCRIPTION :
      • has_midi_input
          TYPE : bool
          ACCES : get
          DESCRIPTION :
      • has_midi_output
          TYPE : bool
          ACCES : get
          DESCRIPTION :
      • mute
          TYPE : bool
          ACCES : get, set, observe
          DESCRIPTION : 1 = désactivé (Activateur de chaîne désactivé)
      • muted_via_solo
          TYPE : bool
          ACCES : get, observe
          DESCRIPTION : 1 = mis en solo en raison d’une autre chaîne en solo.
      • name
          TYPE : unicode
          ACCES : get, set, observe
          DESCRIPTION :
      • solo
          TYPE : bool
          ACCES : get, set, observe
          DESCRIPTION : 1 = solo (interrupteur solo activé)
          ne désactive pas automatiquement Solo dans les autres chaînes.
    • Fonctions
      • delete_device
          Paramètre : index [int]Supprime le périphérique à l’index donné.
  • DrumChain
      Cette classe représente une chaîne de périphériques Drum Rack dans Live. Une DrumChain est un type de Chain, ce qui signifie qu’elle possède tous les Enfants, Propriétés et Fonctions qu’une Chaîne possède. Ci-dessous sont les membres uniques à DrumChain.
    • Propriétés
      • out_note
          TYPE : int
          ACCES : get, set, observe
          DESCRIPTION : Récupère / règle les notes MIDI envoyées aux appareils de la chaîne.
      • choke_group
          TYPE : int
          ACCES : get, set, observe
          DESCRIPTION : Récupère / règle le groupe de Choke de la chaine.
  • ChainMixerDevice
      Cette classe représente le périphérique de mixage d’une chaîne dans Live.
      Chemin d’accès : live_set tracks N devices M chains L mixer_device
      Chemin d’accès : live_set tracks N devices M return_chains L mixer_device
    • Enfants
      • sends
          TYPE : liste de DeviceParameter
          ACCES : get, observe
          DESCRIPTION : [dans les racks d’effets audio et les racks d’instruments uniquement]Pour les racks de batterie, sinon vides.
      • chain_activator
          TYPE : DeviceParameter
          ACCES : get
          DESCRIPTION :
      • panning
          TYPE : DeviceParameter
          ACCES : get
          DESCRIPTION : [dans les racks d’effets audio et les racks d’instruments uniquement]
      • volume
          TYPE : DeviceParameter
          ACCES : get
          DESCRIPTION : [dans les racks d’effets audio et les racks d’instruments uniquement]
  • SimplerDevice
      Cette classe représente une instance de Simpler.
      Un appareil plus simple est un type de Device, ce qui signifie qu’il possède tous les enfants, propriétés et fonctions d’une Device. Ci-dessous sont des membres uniques à SimplerDevice.
    • Enfants
      • sample
          TYPE : Sample
          ACCES : get, observe
          DESCRIPTION : Le sample actuellement chargé dans Simpler.
    • Propriétés
      • can_warp_as
          TYPE : bool
          ACCES : get, observe
          DESCRIPTION :
          1 = warp_as est disponible.
      • can_warp_double
          TYPE : bool
          ACCES : get, observe
          DESCRIPTION :
          1 = warp_double est disponible.
      • can_warp_half
          TYPE : bool
          ACCES : get, observe
          DESCRIPTION :
          1 = warp_half est disponible.
      • multi_sample_mode
          TYPE : bool
          ACCES : get, observe
          DESCRIPTION :
          1 = Simpler est en mode multisample.
      • pad_slicing
          TYPE : bool
          ACCES : get, set, observe
          DESCRIPTION :
          1 = des tranches peuvent être ajoutées en mode Slicing en jouant des notes qui ne sont pas encore affectées à des tranches existantes. 
      • playback_mode
          TYPE : int
          ACCES : get, set, observe
          DESCRIPTION : Récupère / règle le mode de lecture de Simpler.
          0 = Classic Mode
          1 = One-Shot Mode
          2 = Slicing Mode
      • playing_position
          TYPE : float
          ACCES : get, observe
          DESCRIPTION : La position de lecture actuelle dans l’échantillon, exprimée sous la forme d’une valeur comprise entre 0. et 1.
      • playing_position_enabled
          TYPE : bool
          ACCES : get, observe
          DESCRIPTION : 1 = Simpler lit l’échantillon et la position de lecture est affichée.
      • retrigger
          TYPE : bool
          ACCES : get, set, observe
          DESCRIPTION : 1 = Retrigger est activé dans Simpler.
      • slicing_playback_mode
          TYPE : int
          ACCES : get, set, observe
          DESCRIPTION : Récupère / règle le mode de Slicing de Simpler.
          0 = Mono
          1 = Poly
          2 = Thru
      • voices
          TYPE : int
          ACCES : get, set, observe
          DESCRIPTION : Récupère / règle le nombre de Voices.
    • Fonctions
      • crop
          Recadre l’échantillon chargé à la région active entre les marqueurs de début et de fin. 
      • guess_playback_length
          Renvoie : [float] Une estimation en beats pour la durée de lecture entre les marqueurs de début et de fin. 
      • reverse
          Inverse l’échantillon chargé.
      • warp_as
          Paramètres : beats [int]Warp la région active entre les marqueurs de début et de fin en tant que nombre de temps spécifié.
      • warp_double
          Double le tempo de lecture de la région active entre les marqueurs de début et de fin.
      • warp_half
          Divise par 2 le tempo de lecture de la région active entre les marqueurs de début et de fin.
  • SimplerDevice.View
      Représente les aspects d’affichage d’un SimplerDevice.
      Un SimplerDevice.View est un TYPEde Device.View, ce qui signifie qu’il possède toutes les propriétés d’un Device.View. ci-dessous sont les membres uniques à SimplerDevice.View.
    • Propriétés
      • selected_slice
          TYPE : int
          ACCES : get, set, observe
          DESCRIPTION : La tranche actuellement sélectionnée, identifiée par son temps de tranche.
  • Sample
      Cette classe représente un sample chargé dans Simpler.
    • Propriétés
      • beats_granulation_resolution
          TYPE : int
          ACCES : get, set, observe
          DESCRIPTION : Récupère / règle quelle division préserver dans le sample en Beats Mode.
          0 = 1 Bar
          1 = 1/2
          2 = 1/4
          3 = 1/8
          4 = 1/16
          5 = 1/32
          6 = Transients
      • beats_transient_envelope
          TYPE : float
          ACCES : get, set, observe
          DESCRIPTION : Récupère / règle la durée d’un fondu de volume appliqué à chaque segment audio en mode Beats. 0 = fondu la plus rapide, 100 = pas de fondu
      • beats_transient_loop_mode
          TYPE : int
          ACCES : get, set, observe
          DESCRIPTION : Récupère / règle le mode de boucle de transitoire appliqué à chaque segment d’audio en Beats Mode.
          0 = Off
          1 = Loop Forward
          2 = Loop Back-and-Forth
      • complex_pro_envelope
          TYPE : float
          ACCES : get, set, observe
          DESCRIPTION : Récupère / règle le paramètre Envelope en mode Complex Pro.
      • complex_pro_formants
          TYPE : float
          ACCES : get, set, observe
          DESCRIPTION : Récupère / règle le paramètre Formants en mode Complex Pro.
      • end_marker
          TYPE : int
          ACCES : get, set, observe
          DESCRIPTION : Récupère / règle la position du marqueur de fin de sample.
      • file_path
          TYPE : unicode
          ACCES : get, observe
          DESCRIPTION : Récupère le chemin d’accès du fichier de l’échantillon.
      • gain
          TYPE : float
          ACCES : get, set, observe
          DESCRIPTION : Récupère / règle le gain de l’échantillon.
      • length
          TYPE : int
          ACCES : get
          DESCRIPTION : Récupère la longueur du sample en trames.
      • slicing_sensitivity
          TYPE : float
          ACCES : get, set, observe
          DESCRIPTION : Récupère / règle la sensibilité du Slicing. Les valeurs sont comprises entre 0.0 et 1.0.
      • start_marker
          TYPE : int
          ACCES : get, set, observe
          DESCRIPTION : Récupère / règle la position du marqueur de début de l’échantillon.
      • texture_flux
          TYPE : float
          ACCES : get, set, observe
          DESCRIPTION : Récupère / règle le paramètre Flux en mode Texture.
      • texture_grain_size
          TYPE : float
          ACCES : get, set, observe
          DESCRIPTION : Récupère / règle le paramètre Grain Size en mode Texture.
      • tones_grain_size
          TYPE : float
          ACCES : get, set, observe
          DESCRIPTION : Récupère / règle le paramètre Grain Size en mode Tones.
      • warp_markers
          TYPE : bang
          ACCES : observe
          DESCRIPTION : Observe les changements sur la liste de marqueurs Warp.
      • warp_mode
          TYPE : int
          ACCES : get, set, observe
          DESCRIPTION : Récupère / règle le mode Warp.
          0 = Beats Mode
          1 = Tones Mode
          2 = Texture Mode
          3 = Re-Pitch Mode
          4 = Complex Mode
          6 = Complex Pro Mode
      • warping
          TYPE : bool
          ACCES : get, set, observe
          DESCRIPTION : 1 = warping est activé.
      • slicing_style
          TYPE : int
          ACCES : get, set, observe
          DESCRIPTION : Récupère / règle le mode de Slicing.
          0 = Transient
          1 = Beat
          2 = Region
          3 = Manual
      • slicing_beat_division
          TYPE : int
          ACCES : get, set, observe
          DESCRIPTION : Récupère / règle la division de beat de la tranche en mode Beat Slicing Mode.
          0 = 1/16
          1 = 1/16T
          2 = 1/8
          3 = 1/8T
          4 = 1/4
          5 = 1/4T
          6 = 1/2
          7 = 1/2T
          8 = 1 Bar
          9 = 2 Bars
          10 = 4 Bars
      • slicing_region_count
          TYPE : int
          ACCES : get, set, observe
          DESCRIPTION : Récupère / règle le nombre de régions de tranche en mode Region Slicing.
    • Fonctions
      • gain_display_string
          Renvoie : [liste de symboles] La valeur de gain de l’échantillon sous forme de chaîne de caractères, par ex. « 0,0 dB ».
      • insert_slice
          Paramètres : slice_time [int]Insére une nouvelle tranche au temps spécifié s’il n’y en a pas.
      • move_slice
          Paramètres : source_time [int] destination_time [int]Déplace une tranche existante à un temps spécifié.
      • remove_slice
          Paramètres : slice_time [int]Supprime une tranche au temps spécifié si elle existe.
      • clear_slices
          Supprime toutes les tranches créées en mode Manual Slicing.
      • reset_slices
          Réinitialise toutes les tranches modifiées à leurs positions d’origine.
  • WavetableDevice
      Cette classe représente un instrument Wavetable. Un WavetableDevice partage tous les Enfants, Fonctions et Propriétés d’un Device. Ci-dessous sont énumérés les membres qui lui sont propres.
    • Propriétés
      • filter_routing
          TYPE : int
          ACCES : get, set, observe
          DESCRIPTION : Accès au routage du filtre actuel. 0 = Serial, 1 = Parallel, 2 = Split.
      • mono_poly
          TYPE : int
          ACCES : get, set, observe
          DESCRIPTION : Accès au bouton Poly/Mono du Wavetable. 0 = Mono, 1 = Poly.
      • oscillator_1_effect_mode
          TYPE : int
          ACCES : get, set, observe
          DESCRIPTION : Accès au mode d’effet de l’oscillateur 1. 0 = None, 1 = Fm, 2 = Classic, 3 = Modern.
      • oscillator_2_effect_mode
          TYPE : int
          ACCES : get, set, observe
          DESCRIPTION : Accès au mode d’effet de l’oscillateur 2. 0 = None, 1 = Fm, 2 = Classic, 3 = Modern.
      • oscillator_1_wavetable_category
          TYPE :
          ACCES : get, set, observe
          DESCRIPTION : Accès au sélecteur Category de l’oscillateur 1. 
      • oscillator_2_wavetable_category
          TYPE :
          ACCES : get, set, observe
          DESCRIPTION : Accès au sélecteur Category de l’oscillateur 2. 
      • oscillator_1_wavetable_index
          TYPE :
          ACCES : get, set, observe
          DESCRIPTION : Accès à l’index de l’oscillateur 1. 
      • oscillator_2_wavetable_index
          TYPE :
          ACCES : get, set, observe
          DESCRIPTION : Accès à l’index de l’oscillateur 2. 
      • oscillator_1_wavetables
          TYPE : StringVector
          ACCES : get, observe
          DESCRIPTION : liste de noms des tables d’ondes actuellement disponibles pour l’oscillateur 1. Dépend de la sélection de catégorie de table d’ondes actuelle (voir oscillator_1_wavetable_category).
      • oscillator_2_wavetables
          TYPE : StringVector
          ACCES : get, observe
          DESCRIPTION : liste de noms des tables d’ondes actuellement disponibles pour l’oscillateur 2. Dépend de la sélection de catégorie de table d’ondes actuelle (voir oscillator_2_wavetable_category).
      • oscillator_wavetable_categories
          TYPE : StringVector
          ACCES : get
          DESCRIPTION : liste des noms des catégories de tables d’ondes disponibles.
      • poly_voices
          TYPE : int
          ACCES : get, set, observe
          DESCRIPTION : le nombre de voix de polyphonie actuel.
      • unison_mode
          TYPE : int
          ACCES : get, set, observe
          DESCRIPTION : Accès au paramètre du mode unisson de Wavetable.0 = None
          1 = Classic
          2 = Shimmer
          3 = Noise
          4 = Phase Sync
          5 = Position Spread
          6 = Random Note
      • unison_voice_count
          TYPE : int
          ACCES : get, set, observe
          DESCRIPTION : Accès au nombre de voix d’unisson.
      • visible_modulation_target_names
          TYPE : StringVector
          ACCES : get, observe
          DESCRIPTION : liste des noms des cibles de modulation actuellement visibles dans la matrice de modulation.
    • Fonctions
      • add_parameter_to_modulation_matrix
          Paramètre : parameter_to_add [DeviceParameter]Ajoute un paramètre d’instrument à la matrice de modulation. Fonctionne uniquement pour les paramètres modulables (voir is_parameter_modulatable). 
      • get_modulation_target_parameter_name
          Paramètre : index [int]Renvoie le nom du paramètre cible de modulation à l’index dans la matrice de modulation sous la forme d’un [symbole]. 
      • get_modulation_value
          Paramètres : modulation_target_index [int] modulation_source_index [int]Renvoie la quantité de modulation du paramètre situé à modulation_target_index par la source de modulation située à modulation_source_index dans la matrice de modulation de Wavetable. 
      • is_parameter_modulatable
          Paramètre : parameter [DeviceParameter]1 = le paramètre peut être modulé. Appeler avant add_parameter_to_modulation_matrix.
      • set_modulation_value
          Paramètres : modulation_target_index [int] modulation_source_index [int]Définit la quantité de modulation du paramètre situé à modulation_target_index par la source de modulation située à modulation_source_index dans la matrice de modulation de Wavetable. 
  • CompressorDevice
      Cette classe représente un Compresseur dans Live.
      Un CompressorDevice partage tous les Enfants, Fonctions et Propriétés d’un Device. Ci-dessous sont listés les membres qui lui sont propres. 
    • Propriétés
      • available_input_routing_channels
          TYPE : dict
          ACCES : get, observe
          DESCRIPTION : La liste des canaux sources disponibles pour le routage d’entrée du compresseur dans le sidechain. Il est représenté comme un dictionnaire avec la clé suivante:
          available_input_routing_channels [liste]La liste contient des dictionnaires tels que décrits dans input_routing_channel. 
      • available_input_routing_types
          TYPE : dict
          ACCES : get, observe
          DESCRIPTION : La liste des types de source disponibles pour le routage d’entrée du compresseur dans le sidechain. Il est représenté comme un dictionnaire avec la clé suivante:
          available_input_routing_types [liste]La liste contient des dictionnaires comme décrit dans input_routing_type. 
      • input_routing_channel
          TYPE : dict
          ACCES : get, set, observe
          DESCRIPTION : Canal source actuellement sélectionné pour le routage d’entrée du compresseur dans le sidechain. Il est représenté comme un dictionnaire avec les clés suivantes:
          display_name [symbole]identifier [symbole]Peut être défini sur toutes les valeurs trouvées dans les available_input_routing_channels du compresseur.
      • input_routing_type
          TYPE : dict
          ACCES : get, set, observe
          DESCRIPTION :  Type du canal source actuellement sélectionné pour le routage d’entrée du compresseur dans le sidechain. Il est représenté comme un dictionnaire avec les clés suivantes:
          display_name [symbole]identifier [symbole]Peut être défini sur toutes les valeurs trouvées dans les available_input_routing_types du compresseur.
  • PluginDevice
      Cette classe représente un périphérique plug-in. Un PluginDevice est un type de Device, ce qui signifie qu’il possède tous les Enfants, Propriétés et Fonctions qu’un Device possède. Ci-dessous sont les membres uniques à PluginDevice.
    • Propriétés
      • presets
          TYPE : StringVector
          ACCES : get, observe
          DESCRIPTION : Récupère la liste de presets du plug-in.
      • selected_preset_index
          TYPE : int
          ACCES : get, set, observe
          DESCRIPTION : Récupère / règle l’index du preset actuellement sélectionné.
  • MaxDevice
      Cette classe représente un périphérique Max for Live dans Live. Un MaxDevice est un type de Device, ce qui signifie qu’il possède tous les Enfants, Propriétés et Fonctions qu’un Device possède. Ci-dessous sont les membres uniques à MaxDevice. 
    • Propriétés
      • audio_inputs
          TYPE : liste de DeviceIO
          ACCES : get, observe
          DESCRIPTION : liste d’entrées audio que possède le MaxDevice.
      • audio_outputs
          TYPE : liste de DeviceIO
          ACCES : get, observe
          DESCRIPTION : liste de sorties audio que possède le MaxDevice.
    • Fonctions
      • get_bank_count
          Renvoie : [int] le nombre de banques de paramètres.
      • get_bank_name
          Paramètres : bank_index [int]Renvoie : [liste de symbols] Nom de la banque de paramètres spécifiée par bank_index.
      • get_bank_parameters
          Paramètres : bank_index [int]Renvoie : [liste de ints] Les indices des paramètres contenus dans la banque spécifiée par bank_index. Les emplacements vides sont marqués comme -1. L’indice de banque -1 fait référence à la banque « Best of ». 
  • MixerDevice
      Cette classe représente un périphérique de mixage dans Live. Il donne accès au volume, au panoramique et à d’autres objets DeviceParameter. Voir DeviceParameter pour savoir comment les modifier. 
      Chemin d’accès : live_set tracks N mixer_device
    • Enfants
      • sends
          TYPE : liste de DeviceParameter
          ACCES : get, observe
          DESCRIPTION : un Send par piste Retour
      • cue_volume
          TYPE : DeviceParameter
          ACCES : get
          DESCRIPTION : seulement sur la piste Master
      • crossfader
          TYPE : DeviceParameter
          ACCES : get
          DESCRIPTION : seulement sur la piste Master
      • left_split_stereo
          TYPE : DeviceParameter
          ACCES : get
          DESCRIPTION : Le paramètre de panoramique divisé stéréo gauche de la piste.
      • panning
          TYPE : DeviceParameter
          ACCES : get
          DESCRIPTION : Panoramique de la piste
      • right_split_stereo
          TYPE : DeviceParameter
          ACCES : get
          DESCRIPTION : 
          Le paramètre de panoramique divisé stéréo droite de la piste.
      • song_tempo
          TYPE : DeviceParameter
          ACCES : get
          DESCRIPTION : seulement sur la piste Master
      • track_activator
          TYPE : DeviceParameter
          ACCES : get
          DESCRIPTION : Bouton d’activation de la piste
      • volume
          TYPE : DeviceParameter
          ACCES : get
          DESCRIPTION : Volume de la piste
    • Propriétés
      • crossfade_assign
          TYPE : int
          ACCES : get, set, observe
          DESCRIPTION : 0 = A, 1 = aucun, 2 = B [pas sur la piste master]
      • panning_mode
          TYPE : int
          ACCES : get, set, observe
          DESCRIPTION : Accès au mode panoramique du mixeur de pistes : 0 = Stereo, 1 = Split Stereo.
  • Eq8Device
      Cette classe représente une instance de périphérique EQ Eight dans Live.
      Un Eq8Device possède toutes les propriétés, fonctions et enfants d’un Device. Ci-dessous sont des membres uniques à Eq8Device.
    • Propriétés
      • edit_mode
          TYPE : bool
          ACCES : get, set, observe
          DESCRIPTION : Accès au mode d’édition d’EQ Eight, qui bascule le canal actuellement disponible pour l’édition. Les modes d’édition disponibles dépendent du mode global (voir global_mode) et sont codés comme suit: En mode L / R: 0 = L, 1 = R
          En mode M / S: 0 = M, 1 = S
          En mode stéréo: 0 = A, 1 = B (inactif)
      • global_mode
          TYPE : int
          ACCES : get, set, observe
          DESCRIPTION :
          Accès au mode global d’EQ Eight. Les modes sont codés comme suit: 0 = Stereo
          1 = L/R
          2 = M/S
      • oversample
          TYPE : bool
          ACCES : get, set, observe
          DESCRIPTION :
          Accès au paramètre de suréchantillonnage d’EQ Eight. 0 = Off, 1 = On.
  • Eq8Device.View
      Représente les aspects d’affichage d’un Eq8Device.
      Un Eq8Device.View possède tous les Enfants, Propriétés et Fonctions d’un Device.View. Enumérés ci-dessous sont des membres qui lui sont propres.
    • Propriétés
      • selected_band
          TYPE : int
          ACCES : get, set, observe
          DESCRIPTION : L’index de la bande de filtre actuellement sélectionnée.
  • DeviceIO
      Cette classe représente un bus d’entrée ou de sortie d’un périphérique Live.
    • Propriétés
      • available_routing_channels
          TYPE : dictionary
          ACCES : get, observe
          DESCRIPTION : Les canaux disponibles pour ce bus d’entrée / sortie. Les canaux sont représentés comme un dictionnaire avec la clé suivante:
          available_routing_channels [liste]La liste contient des dictionnaires tels que décrits dans routing_channel.
      • available_routing_types
          TYPE : dictionary
          ACCES : get, observe
          DESCRIPTION : Les types disponibles pour ce bus d’entrée / sortie. Les types sont représentés comme un dictionnaire avec la clé suivante:
          available_routing_types [liste]La liste contient des dictionnaires tels que décrits dans routing_type
      • default_external_routing_is_none
          TYPE : bool
          ACCES : get, set
          DESCRIPTION : Règle et récupère si le canal de routage sera défini par défaut sur Aucun plutôt que sur 1/2 lors du passage à un routage externe.
      • routing_channel
          TYPE : dictionary
          ACCES : get, set, observe
          DESCRIPTION : Le canal de routage actuel pour ce bus d’entrée / sortie. Il est représenté comme un dictionnaire avec les clés suivantes:
          display_name [symbole]identifier [symbole]Peut être défini sur n’importe quelle valeur trouvée dans available_routing_channels.
      • routing_type
          TYPE : dictionary
          ACCES : get, set, observe
          DESCRIPTION : Le type de canal de routage actuel pour ce bus d’entrée / sortie. Il est représenté comme un dictionnaire avec les clés suivantes:
          display_name [symbole]identifier [symbole]Peut être défini sur n’importe quelle valeur trouvée dans available_routing_types.
  • CuePoint
      Représente un repère dans la vue Arrangement.
      Chemin d’accès : live_set cue_points N
    • Propriétés
      • name
          TYPE : symbol
          ACCES : get, observe
          DESCRIPTION :
      • time
          TYPE : float
          ACCES : get, observe
          DESCRIPTION : Position du marqueur dans l’arrangement en temps.
    • Fonctions
      • jump
          Régle la position actuelle de lecture de l’arrangement sur le marqueur, quantifiée si le morceau est en cours de lecture. 
  • ControlSurface
      Une ControlSurface peut être atteinte soit directement par le chemin racine control_surfaces N, soit en obtenant une liste des ID de surface de contrôle actifs, en appelant get control_surfaces sur un objet Application.
      Cette dernière liste est dans l’ordre dans lequel les surfaces de contrôle apparaissent dans les préférences Link / MIDI de Live. Notez que le même ordre n’est pas garanti lors de l’obtention d’une surface de contrôle via le chemin control_surfaces N. Une surface de contrôle peut être considérée comme une couche logicielle entre l’API Live et, dans ce cas, Max for Live. Les contrôles individuels sur la surface sont représentés par des objets qui peuvent être saisis et libérés via Max for Live, pour obtenir et redonner un contrôle exclusif (voir grab_control et release_control). De cette façon, certaines parties du matériel peuvent être contrôlées via Max for Live tandis que d’autres parties peuvent conserver leurs fonctionnalités par défaut. En outre, Live propose une surface de contrôle MaxForLive spéciale qui a une fonction register_midi_control. Les développeurs Max for Live peuvent ainsi configurer des surfaces de contrôle entièrement personnalisées en ajoutant et en saisissant des contrôles arbitraires.
      Chemin d’accès : control_surfaces N
    • Fonctions
      • get_control
          Paramètre : name
          Renvoie le contrôle avec le nom donné.
      • get_control_names
          Renvoie la liste de tous les noms de contrôles.
      • grab_control
          Paramètre : control
          Prend possession du contrôle. Cela libère toutes les fonctionnalités standard du contrôle, de sorte qu’il peut être utilisé exclusivement via Max for Live.
      • grab_midi
          Transfére les messages MIDI reçus de la surface de contrôle vers Max for Live.
      • register_midi_control
          Parameters:
          name [symbol]status [int]number [int](seulement pour la surface de controle MaxForLive)
          Enregistre un contrôle MIDI défini par le statut et le numéro. Les codes de statut pris en charge sont 144 (note on), 176 (CC) et 224 (pitchbend).
          Renvoie l’ID LOM associé au contrôle.
          Une fois qu’un contrôle est enregistré et saisi via grab_control, Live transmet les messages MIDI associés qu’il reçoit à Max for Live. Max for Live peut envoyer des valeurs au contrôle (par exemple pour allumer une LED) en appelant send_value sur l’objet de contrôle. 
      • release_control
          Paramètre : control
          Rétablit la fonctionnalité standard du contrôle.
      • release_midi
          Arrête de transférer les messages MIDI reçus de la surface de contrôle vers Max for Live.
      • send_midi
          Paramètre : midi_message [liste de int]Envoie midi_message à la surface de contrôle.
      • send_receive_sysex
          Paramètres:
          sysex_message [liste de int]timeout [symbol, int]Envoie sysex_message à la surface de contrôle et attend une réponse.
          Si le message est suivi du délai d’expiration du message et d’un nombre flottant, cela définit le délai d’expiration de la réponse en conséquence. La valeur de délai d’attente par défaut est 0,2.
          Si la réponse expire et que le MIDI n’a pas été récupéré via grab_midi, il n’est pas transmis à Max for Live. Si le MIDI a été récupéré via Max for Live, les messages reçus sont toujours transférés, mais le délai est toujours signalé.
  • this_device
      Ce chemin racine représente le périphérique contenant l’objet live.path auquel le message goto this_device est envoyé. La classe de cet objet est Device.
      Chemin d’accès : live_set tracks N devices M
Retour haut de page