Consulter les aperçus

Le mode Preview affiche dans un panneau le fichier courant de l’autre panneau. Il permet de consulter des fichiers locaux ou S3 sans les modifier. Pour S3, il lit ou télécharge des données depuis le service : consultez les limites ci-dessous avant de parcourir de gros fichiers.

Afficher un aperçu#

Pour un objet Amazon S3, vous devez disposer de s3:GetObject, ou de s3:GetObjectVersion pour lire une version précise. Le droit d’afficher la liste des objets ne suffit pas pour lire leur contenu. Pour un objet SSE-KMS, les permissions kms:Decrypt et kms:GenerateDataKey sont aussi nécessaires sur la clé concernée. Voir GetObject dans la documentation AWS.

1. Conservez un panneau en Tree and list view, Tree view ou List view.
2. Dans View > Left view ou View > Right view, choisissez Preview pour l’autre côté. Vous pouvez aussi utiliser son bouton de choix de vue.
3. Dans le panneau de navigation, sélectionnez le fichier à consulter.
4. Attendez son chargement, puis utilisez les commandes adaptées au contenu.
5. Pour reprendre la navigation des deux côtés, choisissez une vue de navigation dans le panneau d’aperçu.

Une sélection de dossier demande de choisir un fichier. En sélection multiple, l’aperçu suit le fichier courant, pas l’ensemble des fichiers sélectionnés. Si les deux panneaux sont en Preview, aucun n’alimente l’autre et les aperçus sont vides.

Formats et commandes de consultation#

S3Client choisit le type d’aperçu à partir de l’extension du nom. Les images dépendent des formats pris en charge par Qt ; les fichiers .pdf utilisent le lecteur PDF. Le texte et les types audio ou vidéo utilisent aussi les associations de Tools > Content types…. Une association ne garantit pas qu’un codec puisse décoder le fichier. Consultez les types de contenu.

Le Content-Type renvoyé par S3 ne choisit pas le lecteur d’aperçu. Pour un texte, son charset peut déterminer le décodage. Les extensions PDF, images prises en charge et médias reconnus gardent leur lecteur spécialisé, même si vous les associez à un type texte. Une autre extension associée à audio/* ou video/* utilise le lecteur multimédia.

Un PDF protégé par mot de passe affiche Password:. Saisissez le mot de passe du document puis cliquez sur Open ; il est distinct des identifiants du compte et d’une clé SSE-C. Le zoom et la rotation ne modifient pas le fichier source.

Lorsque le panneau d’aperçu a le focus, Espace alterne Play et Pause pour une animation ou un média. Les choix Volume et Mute sont repris pour les aperçus multimédias suivants. S3 streaming dans la barre d’état indique une lecture S3 par plages ; Buffering… indique que le lecteur attend des données.

Pour copier une image fixe décodée, utilisez Copy image to clipboard dans le menu contextuel du fichier dans le panneau de navigation. Cette commande peut lire ou télécharger l’image si elle n’est pas déjà disponible et respecte la limite des images.

Vous pouvez aussi faire un clic droit sur l’image dans l’aperçu et choisir Copy image to clipboard. Pour une animation, cette commande copie l’image courante. La copie conserve les pixels décodés, sans appliquer le zoom ni la rotation de l’affichage.

Les listes de lecture ou manifestes tels que .m3u, .m3u8, .pls, .mpd et .xspf ne lancent pas les médias qu’ils référencent. Ils sont traités comme du texte si leur association le permet, sinon l’aperçu est indisponible.

Téléchargements et limites de taille#

Les images nécessitent la lecture intégrale de leur contenu, qui doit rester strictement inférieur au seuil configuré. Pour une réponse S3 gzip, ce seuil porte sur le contenu du fichier après décompression, avant décodage de l’image. Une lecture ou un téléchargement peut avoir commencé avant que l’aperçu soit refusé. Les PDF S3 sont téléchargés intégralement avant consultation ; les PDF locaux utilisent directement le fichier local ou une copie en mémoire. Les textes ne chargent que leur début, dans la limite configurée. Les médias S3 sont lus par plages d’octets et peuvent commencer avant le téléchargement du fichier entier.

Pour modifier les réglages, ouvrez Tools > Options…, choisissez l’onglet Preview, puis validez avec OK. Cancel abandonne les changements. Sélectionnez ensuite un autre fichier puis revenez au fichier concerné pour reconstruire l’aperçu avec les nouveaux réglages.

MiB et KiB sont des unités binaires : 1 MiB vaut 1 048 576 octets et 1 KiB vaut 1 024 octets. Les limites des images, PDF et textes sont indépendantes.

Le téléchargement parallèle n’est possible que si S3Client peut vérifier que les parties lues appartiennent à la même version du fichier et si le service accepte les lectures par plages d’octets. Le nombre configuré est un maximum ; certains fichiers utilisent moins de requêtes.

Cache et aperçus partiels#

Le cache multimédia conserve en mémoire les parties du média courant déjà chargées. Choisir une autre position de lecture, ou revenir à une partie qui n’est plus en cache, peut demander de nouvelles lectures S3. Changer de fichier ou quitter l’aperçu annule les lectures devenues inutiles et libère ce cache. Il ne fournit pas de copie permanente à consulter hors ligne.

Un PDF S3 peut être conservé en mémoire ou dans un fichier temporaire selon sa taille et la mémoire disponible. Ce fichier contient les données reçues, après décompression éventuelle ; S3Client ne les rechiffre pas localement, même si l’objet utilise un chiffrement côté serveur. Un éventuel mot de passe propre au PDF reste distinct. S3Client supprime le fichier temporaire lorsqu’il libère cet aperçu. Prévoyez donc de l’espace dans le répertoire temporaire du système pour les PDF volumineux.

Partial preview signifie que seul le début du texte a été lu, ou que la limite de décompression a été atteinte. L’aperçu ne permet pas de vérifier la fin du fichier ni l’intégrité complète d’un flux gzip tronqué. Pour consulter le contenu entier, téléchargez le fichier puis ouvrez-le dans l’application adaptée ; augmenter la limite de texte ne permet pas de dépasser 64 KiB.

Le décodage du texte utilise en priorité sa marque d’ordre des octets (BOM), puis le charset du type de contenu reçu ou associé à l’extension, puis UTF-8. Decoding errors or encoding mismatch signale des caractères invalides, un encodage déclaré inconnu ou une incohérence d’encodage. Vérifiez le fichier et ses métadonnées ou son association de type avant de considérer le texte affiché comme fidèle.

Chiffrement, archivage et erreurs de lecture#

Les anciennes versions d’objets peuvent être consultées lorsqu’elles ont un contenu accessible. Les marqueurs de suppression affichent Delete markers cannot be previewed. et ne peuvent pas être lus.

Un objet archivé doit être restauré et redevenu lisible avant l’aperçu. Une entrée visible dans la liste ne prouve pas que ses données sont immédiatement disponibles. Utilisez Restore archived object… dans le panneau de navigation lorsque cette commande est proposée, puis attendez la fin de la restauration. Consultez les classes de stockage et archives.

The source object is archived and must be restored before its content can be read. demande une restauration. The source object is being restored and is not readable yet. demande d’attendre sa fin. The source storage class is not configured for this bucket. signifie que la politique du compte ne décrit pas cette classe pour le bucket : vérifiez File > Accounts… > Edit… > Capabilities > Storage classes et la politique applicable avant de relancer l’aperçu.

La lecture SSE-C nécessite HTTPS et n’est pas proposée pour les buckets de répertoire. Dans File > Accounts…, sélectionnez le compte, cliquez sur Edit…, puis ouvrez Capabilities > Encryption. Cochez SSE-C si le service le prend en charge. Ouvrez ensuite Encryption policies > Features. Dans Policy, choisissez la politique de chiffrement applicable au bucket, puis vérifiez SSE-C operations > SSE-C reading > Read object data et Read object metadata selon les lectures effectuées. Vérifiez Account default policy et les affectations au bucket dans Assignments, puis enregistrez le compte avec OK. Ces réglages ne fournissent ni clé ni autorisation. Consultez les capacités du compte.

Si une lecture S3 échoue avant d’avoir obtenu du contenu et si le compte prend en charge cette lecture SSE-C, SSE-C read key… peut devenir disponible dans l’aperçu. Cette commande reste également disponible lorsqu’une clé temporaire est déjà utilisée.

1. Cliquez sur SSE-C read key….
2. Dans SSE-C read key, choisissez Temporary SSE-C key.
3. Dans Encoding:, choisissez Base64 ou Hexadecimal, puis renseignez Key:. La clé décodée doit contenir exactement 32 octets ; en hexadécimal, saisissez 64 caractères.
4. Vous pouvez aussi cliquer sur Import file… et choisir un fichier binaire de 32 octets exactement.
5. Cliquez sur OK pour relancer l’aperçu avec cette clé.

No SSE-C key relance la lecture sans clé fournie. La clé temporaire n’est pas enregistrée comme réglage du compte ; changer d’objet réinitialise ce choix. Une erreur de format après une lecture réussie ne se corrige pas en fournissant une clé.

Les images, PDF et textes S3 peuvent être décompressés si leur réponse indique Content-Encoding: gzip, dans leurs limites respectives. La lecture multimédia S3 par plages refuse la compression HTTP : Streaming cannot read an object stored with HTTP content compression. indique cette restriction. Téléchargez le contenu pour le consulter autrement.

This file cannot be previewed. indique un type non pris en charge. The media format or codec cannot be decoded. indique que le lecteur multimédia ne peut pas décoder le contenu. Unable to load the preview. est suivi de la cause de lecture ; vérifiez la connexion, les permissions, la clé et la disponibilité de l’objet. Après correction, changez de sélection puis revenez au fichier, ou utilisez Retry preview pour un média lorsque la commande est disponible.

Incorrect password. Please try again. demande un autre mot de passe du PDF. This PDF uses an unsupported security scheme. indique que le lecteur PDF ne prend pas en charge la protection du document : téléchargez-le pour l’ouvrir avec un lecteur compatible. Ces erreurs concernent le document déjà chargé, pas les permissions S3.