Live Object Model Français

Recherche

• 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
    • get_bugfix_version
      Renvoie : le 2 dans Live 9.1.2.
    • get_document
      Renvoie : le Live Set actuel.
    • get_major_version
      Renvoie : le 9 dans Live 9.1.2.
    • get_minor_version
      Renvoie : le 1 dans Live 9.1.2.
    • press_current_dialog_button
      Paramètre : index Appuie sur le bouton avec l’index donné dans la boîte de dialogue actuelle.
• 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
    • delete_all_chains
      Supprime toutes les chaines
• 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